skill CX Codex

speckit-converge — Claude Code skill: validate code against spec

Q: How do I install speckit-converge in Claude Code?

Run `npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a claude-code` in your terminal, then open `~/.claude/skills/speckit-converge/SKILL.md`.

Q: When should I run speckit-converge?

After `/speckit-implement` finishes all current tasks in `tasks.md` and `/speckit-tasks` has produced a complete task list.

Compares your current codebase against requirements in spec.md, plan.md, and tasks.md, then appends unfinished work as new tasks to tasks.md. Works with spec-kit project structure.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a claude-code

Open on GitHub

What speckit-converge does

Run this skill after /speckit-implement completes all current tasks. It reads your specification, plan, and task list; scans the codebase for compliance; and identifies which requirements, acceptance criteria, and architecture decisions remain unbuilt or incomplete. Each gap becomes a new task appended to tasks.md, so implement knows what comes next.

The skill operates within projects that follow the spec-kit layout, with a .specify/ directory for specs and metadata. It preserves all existing tasks, leaves spec.md and plan.md untouched, and makes no changes to your code—only appends new tasks to complete the feature. When the code already satisfies all requirements, tasks.md remains unchanged.

It also validates your code against project principles defined in .specify/memory/constitution.md, if present, and flags violations as remediation tasks.

What it helps with

identify unimplemented requirements from spec.md
detect gaps between plan.md decisions and actual codebase structure
append missing work to the task queue without rewriting existing tasks
validate code compliance with project constitution principles

Example prompts for the agent

Run /speckit-converge to check whether your plan is fully built
After finishing all tasks in tasks.md, run /speckit-converge to see what remains
Use /speckit-converge to ensure your codebase matches the architecture in plan.md

How to install speckit-converge

1Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a claude-code

2Manually: put the files in place

~/.claude/skills/speckit-converge/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/speckit-converge/

1Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a codex

2Manually: put the files in place

.agents/skills/speckit-converge/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a cursor

2Manually: put the files in place

.cursor/skills/speckit-converge/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install dceoy/speckit-agent-skills speckit-converge

2Manually: put the files in place

.github/skills/speckit-converge/SKILL.md

1Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a gemini-cli

2Platform CLI

gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-converge

Manually: put the files in place

.devin/skills/speckit-converge/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about speckit-converge

How do I install speckit-converge in Claude Code?

Run npx skills add dceoy/speckit-agent-skills --skill speckit-converge -a claude-code in your terminal, then open ~/.claude/skills/speckit-converge/SKILL.md.

What does speckit-converge do?

It reads your specification, plan, and task list, then scans the codebase to find requirements that are unmet, incomplete, or only partially satisfied. Each gap becomes a traceable task appended to tasks.md for the next implementation cycle.

When should I run speckit-converge?

After /speckit-implement finishes all current tasks in tasks.md and /speckit-tasks has produced a complete task list.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set11

speckit-constitution This skill writes and updates the project constitution in .specify/memory/constitution.md, turning your principles into a versioned governance doc. CX Codex +1 2,400installs speckit-implement Executes development tasks from tasks.md in spec-kit projects. It validates readiness checklists, triggers pre-implementation hooks, and configures ignore files. CX Codex +1 2,400installs speckit-tasks This skill turns plan.md and spec.md into a tasks.md ordered by dependencies and user stories. Useful when the feature is already described in spec-kit but the work queue is not. CX Codex +1 2,400installs speckit-clarify Scans a feature spec for gaps, asks up to 5 targeted questions and writes the answers back into the spec file. CX Codex +1 2,200installs speckit-taskstoissues Turns tasks from tasks.md into dependency-ordered GitHub issues. The skill is marked deprecated and points to a replacement extension. CX Codex +1 1,500installs speckit-baseline This skill reads your source files and turns them into a framework-agnostic feature spec with user stories and requirements. Useful when a codebase exists but written requirements do not. CX Codex +1 1,500installs speckit-checklist Generates a custom requirements-quality checklist for a feature specification. It helps reviewers catch ambiguous phrasing and missing edge cases before coding starts. CX Codex +1 1,500installs claude-command-converter Converts Claude Code slash commands into portable Agent Skills format. Useful when migrating workflows to Codex, Cursor, or Copilot. CX Codex +1 1,400installs