# speckit-analyze

speckit-analyze is a Claude Code skill that inspects consistency across spec.md, plan.md, and tasks.md. Runs strictly in read-only mode right before feature implementation starts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1600 installs · ★ 174 repo stars
- Author: github-spec-kit
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-analyze/SKILL.md
- Updated: 2026-11-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/speckit-analyze

## What it does

speckit-analyze validates that specifications, technical plans, and generated tasks align without gaps or contradictory requirements. Prior to checking core files, it inspects `.specify/extensions.yml` for execution hooks and runs the prerequisite verification script. If `data-model.md` is present, the inspection also maps entity fields and constraint definitions to the planned tasks.

The routine never alters project files. It surfaces findings inside a structured report alongside an optional remediation plan. Any conflict with `.specify/memory/constitution.md` gets tagged as critical because project principles override individual tasks. Principles cannot be softened or skipped during this step.

Operation requires an initialized spec-kit directory layout under `.specify/` and a completed `tasks.md`. Analysis stops immediately if any mandatory prerequisite file cannot be found.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/speckit-analyze/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/speckit-analyze/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/speckit-analyze/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/speckit-analyze/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dceoy/speckit-agent-skills skills/speckit-analyze
```

2. **Manually: put the files in place**
- File: `.github/skills/speckit-analyze/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-analyze
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/speckit-analyze/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-analyze/SKILL.md

## When to use it
- spec-kit artifact validation
- detect contradictions between requirements and task lists
- verify requirement coverage across implementation steps
- match data-model constraints against planned tasks
- catch violations of the project constitution

## Example prompts
- Run speckit-analyze on the current feature branch
- Analyze consistency across spec, plan, and tasks
- Run /speckit-analyze focusing on user story coverage

## Similar
- [speckit-companion](https://affpapa.org/en/nevibecode/plugins/speckit-companion.md) — plugin · ★ 110 repo stars
- [speckit.companion.living-show](https://affpapa.org/en/nevibecode/commands/speckitcompanionliving-show.md) — command · ★ 110 repo stars
- [planning-prd-agent](https://affpapa.org/en/nevibecode/agents/planning-prd-agent.md) — subagent · ★ 1013 repo stars
- [gsd-spec-phase](https://affpapa.org/en/nevibecode/skills/gsd-spec-phase.md) — skill · 575 installs
- [speckit.checklist](https://affpapa.org/en/nevibecode/commands/speckitchecklist.md) — command · ★ 117 repo stars
- [speckit.optimize](https://affpapa.org/en/nevibecode/commands/speckitoptimize.md) — command · ★ 372 repo stars

From the same set: [dceoy/speckit-agent-skills](https://affpapa.org/en/nevibecode/by/dceoy/speckit-agent-skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
