Skip to content

feat: improve implement-spec skill score (53% → 96%) #1531

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
yogesh-tessl wants to merge 1 commit into from
Closed

feat: improve implement-spec skill score (53% → 96%) #1531

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 1 addition & 21 deletions .claude/skills/implement-spec/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,9 @@
---
name: implement-spec
description: Autonomous one-shot implementation from an approved spec (local/cloud only)
description: "Autonomous spec-to-code implementation: plans changes from an approved spec, executes code modifications (parallel where possible), runs QA cycles (cargo fmt, clippy in host+zk modes, nextest), validates correctness against spec criteria, and posts PR summaries. Runs locally or in Claude Code cloud — needs repo write access. USE FOR: - Implementing features from approved specifications - Executing spec-driven development workflows - Building code changes from design documents or feature plans - Running full plan-execute-validate cycles on feature specs TRIGGERS: - \"implement spec\", \"build from spec\", \"execute spec\" - \"implement feature\", \"code from specification\" - \"implement the plan\", \"build this feature\", \"run implementation\""
argument-hint: "[spec file path]"
---

<Purpose>
Take an approved spec and autonomously implement it: plan the work, execute in parallel where possible, run QA cycles until tests pass, and validate the result. Produces working, verified code from the spec in a single pass.

This skill runs locally or in Claude Code cloud (claude.ai/code) — NOT in CI. It needs write access to the repo to create commits and push to the PR branch.
</Purpose>

<Execution_Policy>
- The spec is the source of truth. Implement what it says, not more.
- Read CLAUDE.md for project conventions, testing requirements, and architecture.
Expand Down Expand Up @@ -114,18 +108,4 @@ Fix any issues found and re-validate.

</Steps>

<Examples>
<Good>
User: `/implement-spec`
Action: Reads the spec from the PR, creates a plan, implements it, runs QA, validates, pushes commits.
Why good: Full autonomous execution from spec to working code.
</Good>

<Bad>
User: `/implement-spec` on a spec without `claude-spec-approved`
Action: Should warn that the spec hasn't been analyzed yet, but proceed if the user insists.
Why bad situation: Implementation from an unanalyzed spec risks rework.
</Bad>
</Examples>

Task: Implement the spec in this PR. {{ARGUMENTS}}
1 change: 1 addition & 0 deletions .claude/skills/update-docs/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
---
name: update-docs
description: Analyze code changes since a base commit and update the Jolt docs (book/) accordingly
argument-hint: <base-commit-hash>
allowed-tools: Bash, Read, Edit, Write, Glob, Grep, Task
Expand Down