Agent-Skills.md

Agent Skills: SpecSwarm Build Workflow

Spec-driven feature development workflow. Triggers on build/create/add/implement/develop intent.

UncategorizedID: MartyBonacci/specswarm/ss-build

Repository

MartyBonacci/specswarm
MartyBonacciLicense: MIT
644

Install this agent skill to your local

pnpm dlx add-skill https://github.com/MartyBonacci/specswarm/tree/HEAD/plugins/ss/skills/ss-build

Skill Files

Browse the full folder contents for ss-build.

Download Skill

Loading file tree…

plugins/ss/skills/ss-build/SKILL.md

Skill Metadata

Name
ss-build
Description
Checks if build workflow should continue to next phase

SpecSwarm Build Workflow

Provides natural language access to /ss:build command.

Dynamic Context

Current build state: !cat .specswarm/build-loop.state 2>/dev/null || echo "No active build"

When to Invoke

Trigger this skill when the user mentions:

  • Building, creating, or adding features
  • Implementing or developing functionality
  • Making or adding components
  • Any request to build software features

Examples:

  • "Build user authentication"
  • "Create a payment system"
  • "Add dashboard analytics"
  • "Implement shopping cart"

Instructions

Skill-Based Routing:

  1. Detect that user mentioned building/creating software

  2. Extract the feature description from their message

  3. Route based on intent clarity:

    Clear intent - Execute directly:

    • Clear feature requests: "Please build a simple website", "Create user authentication with JWT", "Add dashboard analytics"
    • Action: Immediately run /ss:build "feature description"

    Ambiguous intent - Ask for confirmation:

    • Less specific: "Add authentication", "Work on the app"
    • Action: Use AskUserQuestion tool with two options:
      • Option 1 (label: "Run /ss:build"): Use SpecSwarm's complete workflow
      • Option 2 (label: "Process normally"): Handle as regular Claude Code request

  4. If user selects Option 2, process normally without SpecSwarm

  5. After command completes, STOP - do not continue with ship/merge

What the Build Command Does

/ss:build runs complete workflow:

  • Creates specification
  • Asks clarifying questions
  • Generates implementation plan
  • Breaks down into tasks
  • Implements all tasks
  • Validates quality

Stops after implementation - does NOT merge/ship/deploy.

Semantic Understanding

This skill should trigger not just on exact keywords, but semantic equivalents:

Build equivalents: build, create, make, develop, implement, add, construct, set up, establish, design Feature terms: feature, component, functionality, module, system, page, form, interface

Example

User: "Build user authentication with JWT"