Skip to content

aiskillstore/marketplace / skills/89jobrien/spec-driven-development

spec-driven-development

Verified

Spec-Driven Development (SDD) methodology based on GitHub's SpecKit. Use for structured AI-assisted development with constitutional governance, phased workflows, and multi-agent coordination. Implements 7-phase process from constitution to implementation.

FileKindSize
SKILL.mdskill md13.7 KB
skill-report.jsonconfig30.6 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-05T13:52:07.258Z",
    "slug": "89jobrien-spec-driven-development",
    "source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/spec-driven-development",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "de264459be0c6f2d86d047e12629997e517d46b5a65b9596966bf67c66a3c019",
    "tree_hash": "55e141b58636e43dcf7b4bbb624db5ccae02f6ba5689c2378d576d7c8e1ef859",
    "provenance": {
      "model_effective": "codex",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "spec-driven-development",
    "description": "Guides AI-assisted development through a seven-phase Spec-Driven Development workflow with constitution, specification, clarification, planning, analysis, task breakdown, and implementation phases.",
    "summary": "Run a governed Spec-Driven Development workflow from project principles to validated implementation tasks.",
    "icon": "📦",
    "version": "1.0.2",
    "author": "Joseph OBrien",
    "license": "MIT",
    "tags": [
      "spec-driven-development",
      "requirements",
      "planning",
      "ai-workflows",
      "task-breakdown"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands"
    ],
    "category": "coding"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "All static findings were false positives caused by Markdown backticks, example directory trees, and descriptive mentions of Bash or PowerShell script variants. No evidence of executable code, command invocation, reconnaissance behavior, prompt injection, data exfiltration, or malicious intent was found in SKILL.md.",
    "remediation": [],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 43,
            "line_end": 43
          },
          {
            "file": "SKILL.md",
            "line_start": 59,
            "line_end": 59
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 111,
            "line_end": 111
          },
          {
            "file": "SKILL.md",
            "line_start": 139,
            "line_end": 139
          },
          {
            "file": "SKILL.md",
            "line_start": 145,
            "line_end": 145
          },
          {
            "file": "SKILL.md",
            "line_start": 149,
            "line_end": 149
          },
          {
            "file": "SKILL.md",
            "line_start": 150,
            "line_end": 150
          },
          {
            "file": "SKILL.md",
            "line_start": 151,
            "line_end": 151
          },
          {
            "file": "SKILL.md",
            "line_start": 152,
            "line_end": 152
          },
          {
            "file": "SKILL.md",
            "line_start": 168,
            "line_end": 168
          },
          {
            "file": "SKILL.md",
            "line_start": 169,
            "line_end": 169
          },
          {
            "file": "SKILL.md",
            "line_start": 170,
            "line_end": 170
          },
          {
            "file": "SKILL.md",
            "line_start": 191,
            "line_end": 191
          },
          {
            "file": "SKILL.md",
            "line_start": 197,
            "line_end": 197
          },
          {
            "file": "SKILL.md",
            "line_start": 257,
            "line_end": 257
          },
          {
            "file": "SKILL.md",
            "line_start": 287,
            "line_end": 294
          },
          {
            "file": "SKILL.md",
            "line_start": 294,
            "line_end": 302
          },
          {
            "file": "SKILL.md",
            "line_start": 302,
            "line_end": 307
          },
          {
            "file": "SKILL.md",
            "line_start": 307,
            "line_end": 315
          },
          {
            "file": "SKILL.md",
            "line_start": 315,
            "line_end": 320
          },
          {
            "file": "SKILL.md",
            "line_start": 320,
            "line_end": 367
          },
          {
            "file": "SKILL.md",
            "line_start": 367,
            "line_end": 384
          },
          {
            "file": "SKILL.md",
            "line_start": 384,
            "line_end": 392
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 53
          },
          {
            "file": "SKILL.md",
            "line_start": 373,
            "line_end": 373
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 43,
        "line_end": 43,
        "snippet": "- `.specify/` directory structure"
      },
      {
        "id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 59,
        "line_end": 59,
        "snippet": "**Artifact:** `memory/constitution.md`"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 81,
        "snippet": "**Artifact:** `specs/[feature]/spec.md`"
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 111,
        "line_end": 111,
        "snippet": "**Artifact:** Updates `specs/[feature]/spec.md`"
      },
      {
        "id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 139,
        "line_end": 139,
        "snippet": "- Output: `research.md` with all uncertainties resolved"
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 145,
        "line_end": 145,
        "snippet": "- Outputs: `data-model.md`, contract schemas, agent-specific context"
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 149,
        "line_end": 149,
        "snippet": "- `specs/[feature]/plan.md`"
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 150,
        "line_end": 150,
        "snippet": "- `specs/[feature]/research.md`"
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 151,
        "line_end": 151,
        "snippet": "- `specs/[feature]/data-model.md`"
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 152,
        "line_end": 152,
        "snippet": "- `specs/[feature]/contracts/`"
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 168,
        "line_end": 168,
        "snippet": "- `specs/[feature]/spec.md`"
      },
      {
        "id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 169,
        "line_end": 169,
        "snippet": "- `specs/[feature]/plan.md`"
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 170,
        "line_end": 170,
        "snippet": "- `specs/[feature]/tasks.md`"
      },
      {
        "id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 191,
        "line_end": 191,
        "snippet": "**Artifact:** `specs/[feature]/tasks.md`"
      },
      {
        "id": "external_commands:SKILL.md:197:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 197,
        "line_end": 197,
        "snippet": "- Optional parallelization marker (`||`)"
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 257,
        "line_end": 257,
        "snippet": "- Optional `||` marker in task format"
      },
      {
        "id": "external_commands:SKILL.md:287:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 287,
        "line_end": 294,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 294,
        "line_end": 302,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:302:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 302,
        "line_end": 307,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:307:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 307,
        "line_end": 315,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:315:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 315,
        "line_end": 320,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:320:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 320,
        "line_end": 367,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:367:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 367,
        "line_end": 384,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:384:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 384,
        "line_end": 392,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:53:powershell-invocation",
        "category": "external_commands",
        "severity": "high",
        "pattern": "PowerShell invocation",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 53,
        "snippet": "- Generate script variants (bash/powershell)"
      },
      {
        "id": "external_commands:SKILL.md:373:powershell-invocation",
        "category": "external_commands",
        "severity": "high",
        "pattern": "PowerShell invocation",
        "file": "SKILL.md",
        "line_start": 373,
        "line_end": 373,
        "snippet": "│   └── *.ps1                    # PowerShell automation scripts"
      },
      {
        "id": "blocker:SKILL.md:396:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 396,
        "line_end": 396,
        "snippet": "9. **Avoid implementation details** in specification phase"
      },
      {
        "id": "blocker:SKILL.md:399:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 399,
        "line_end": 401,
        "snippet": "## Pitfalls to Avoid"
      },
      {
        "id": "blocker:SKILL.md:425:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 425,
        "line_end": 425,
        "snippet": "### Scenario 4: Rapid Prototyping"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:43:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:59:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:145:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:152:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:168:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:169:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:170:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:191:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:197:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:257:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The backticks wrap Markdown file paths, artifact names, or a task marker for documentation. There is no Ruby code, shell command, or execution context."
      },
      {
        "id": "external_commands:SKILL.md:287:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:294:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:302:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:307:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:315:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:320:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:367:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:384:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The match is a Markdown code fence around workflow examples or a directory tree. It does not contain executable shell syntax or command invocation."
      },
      {
        "id": "external_commands:SKILL.md:53:powershell-invocation",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a descriptive mention of PowerShell script variants or .ps1 files in the documented structure. The skill does not invoke PowerShell or provide executable commands."
      },
      {
        "id": "external_commands:SKILL.md:373:powershell-invocation",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This is a descriptive mention of PowerShell script variants or .ps1 files in the documented structure. The skill does not invoke PowerShell or provide executable commands."
      },
      {
        "id": "blocker:SKILL.md:396:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The matched text is a best-practice item, section heading, or scenario title. It is unrelated to system reconnaissance and does not request host enumeration."
      },
      {
        "id": "blocker:SKILL.md:399:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The matched text is a best-practice item, section heading, or scenario title. It is unrelated to system reconnaissance and does not request host enumeration."
      },
      {
        "id": "blocker:SKILL.md:425:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "The matched text is a best-practice item, section heading, or scenario title. It is unrelated to system reconnaissance and does not request host enumeration."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 433,
    "audit_model": "codex",
    "audited_at": "2026-07-05T13:52:07.258Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Structure AI Development With Specs",
    "value_statement": "Complex AI-assisted projects can lose clarity before implementation starts. This skill guides teams through phased specifications, governance, planning, analysis, and task execution.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "spec-driven development",
      "SpecKit",
      "AI-assisted development",
      "requirements planning",
      "technical specifications",
      "task breakdown",
      "multi-agent workflow"
    ],
    "actual_capabilities": [
      "Defines a seven-phase workflow from project constitution to implementation.",
      "Guides creation of specifications, plans, research notes, data models, and task lists.",
      "Uses quality gates for clarifications, analysis, and constitution alignment.",
      "Explains task dependencies, user story grouping, and optional parallel work markers.",
      "Describes coordination patterns for Claude, Codex, Claude Code, and other coding agents."
    ],
    "limitations": [
      "It provides methodology guidance, not executable automation.",
      "It does not include the referenced scripts or templates as files.",
      "Users must adapt artifacts to their project stack and team rules.",
      "Security, compliance, and architecture decisions still require human review."
    ],
    "use_cases": [
      {
        "title": "Turn Feature Ideas Into Requirements",
        "description": "Create stakeholder-focused specifications with scenarios, acceptance criteria, edge cases, and measurable success criteria.",
        "target_user": "Product managers"
      },
      {
        "title": "Coordinate Parallel Delivery",
        "description": "Break planned work into dependency-aware tasks that multiple developers or AI agents can execute with clear handoffs.",
        "target_user": "Engineering leads"
      },
      {
        "title": "Prepare AI Coding Sessions",
        "description": "Move from clarified goals to implementation-ready tasks before asking an AI coding assistant to modify files.",
        "target_user": "Solo developers"
      }
    ],
    "prompt_templates": [
      {
        "title": "Start a Feature Specification",
        "scenario": "Beginner prompt for turning an idea into a structured specification.",
        "prompt": "Use spec-driven-development to create a stakeholder-focused specification for [feature]. Ask clarification questions before planning."
      },
      {
        "title": "Clarify Missing Requirements",
        "scenario": "Intermediate prompt for resolving ambiguity before planning work.",
        "prompt": "Review my specification for [feature]. Identify the highest-impact ambiguities and ask one question at a time."
      },
      {
        "title": "Create an Implementation Plan",
        "scenario": "Advanced prompt for turning a clarified specification into a technical plan.",
        "prompt": "Use the SDD planning phase for [feature]. Produce the technical context, research needs, design artifacts, and quality gates."
      },
      {
        "title": "Coordinate Multi-Agent Execution",
        "scenario": "Advanced prompt for dividing work across people or AI coding agents.",
        "prompt": "Create a dependency-ordered task breakdown for [feature]. Mark independent tasks and define handoff points for multiple agents."
      }
    ],
    "output_examples": [
      {
        "input": "A team wants to build account recovery but only has a rough feature idea.",
        "output": "A structured feature specification with user scenarios, acceptance criteria, edge cases, functional requirements, and success criteria."
      },
      {
        "input": "An engineering lead needs several agents to work on one feature safely.",
        "output": "A task plan grouped by user story, with dependencies, foundational work, validation steps, and parallel work markers."
      },
      {
        "input": "A project has specs, plans, and tasks that may not agree.",
        "output": "A severity-ranked analysis report covering duplications, ambiguities, underspecified items, and constitution conflicts."
      }
    ],
    "best_practices": [
      "Establish the constitution before creating feature plans or implementation tasks.",
      "Resolve high-impact clarification questions before selecting technologies or writing tasks.",
      "Run analysis before implementation to catch inconsistencies across specs, plans, and tasks."
    ],
    "anti_patterns": [
      "Starting implementation before the specification has clear acceptance criteria.",
      "Creating parallel tasks without explicit dependencies and handoff points.",
      "Treating the methodology as a substitute for security, compliance, or architecture review."
    ],
    "faq": [
      {
        "question": "Does this skill write code automatically?",
        "answer": "No. It provides a methodology for preparing specifications, plans, analysis, and task breakdowns."
      },
      {
        "question": "Can I use it with Claude, Codex, and Claude Code?",
        "answer": "Yes. The workflow describes agent-neutral artifacts that can guide several AI coding tools."
      },
      {
        "question": "When should I use this skill?",
        "answer": "Use it when a feature needs clear requirements, governance, planning, and implementation sequencing before coding starts."
      },
      {
        "question": "Does it require GitHub SpecKit to be installed?",
        "answer": "No. The skill explains a SpecKit-inspired workflow, but this package only contains documentation."
      },
      {
        "question": "Is it useful for small prototypes?",
        "answer": "Yes. Use a lighter version with focused specifications, fewer planning artifacts, and small user stories."
      },
      {
        "question": "What should users review manually?",
        "answer": "Users should review security requirements, compliance constraints, architecture choices, and any generated implementation tasks."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 433
    }
  ]
}
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall