/speckit.init
Agent skill wrapper for the Claude command /speckit.init.
When the original command text references {{INPUT}}, $1, or named arguments, map them from the user's current request.
Command Instructions
Set up the .specify/ directory structure for Specification-Driven Development in the current project by downloading the latest files from the upstream github/spec-kit repository.
Steps
- Check for existing setup: Look for
.specify/in the project root. If it already exists, stop and tell the user to run/speckit.init.updateinstead. - Clone upstream:
UPSTREAM_DIR=$(mktemp -d) git clone --depth 1 https://github.com/github/spec-kit.git "$UPSTREAM_DIR"If the clone fails, report the error and stop. - Copy files from upstream into the project root, preserving the paths exactly: Upstream source Local destination
.specify/memory/constitution.md.specify/memory/constitution.md.specify/scripts/bash/common.sh.specify/scripts/bash/common.sh.specify/scripts/bash/setup-plan.sh.specify/scripts/bash/setup-plan.sh.specify/scripts/bash/check-prerequisites.sh.specify/scripts/bash/check-prerequisites.sh.specify/scripts/bash/update-agent-context.sh.specify/scripts/bash/update-agent-context.sh.specify/scripts/bash/create-new-feature.sh.specify/scripts/bash/create-new-feature.sh.specify/templates/agent-file-template.md.specify/templates/agent-file-template.md.specify/templates/checklist-template.md.specify/templates/checklist-template.md.specify/templates/tasks-template.md.specify/templates/tasks-template.md.specify/templates/spec-template.md.specify/templates/spec-template.md.specify/templates/plan-template.md.specify/templates/plan-template.mdCreate any intermediate directories as needed. Preserve file permissions (especially executable bits on shell scripts). - Clean up:
rm -rf "$UPSTREAM_DIR" - Detect project name: Try in order —
git remote get-url origin(extract repo name from URL),package.jsonnamefield,mix.exsapp name, directory basename. Use this asPROJECT_NAME. - Personalize
.specify/memory/constitution.md: Replace placeholder tokens in the downloaded file:
- [PROJECT_NAME] → detected project name - [YYYY-MM-DD] → today's date in ISO format
- Create
.specify/specs/: Make this directory for feature specification artifacts (one subdirectory per feature). This directory is not present in upstream. - Update
.gitignore: Only if.gitignoreexists and does not already contain.specify/. Append.specify/as a new line. If no.gitignoreexists, skip and note it. - Report all directories and files created with their paths.
- Present the SDD workflow overview:
Spec-Driven Development workflow: /speckit.constitution → Define governing principles (run once per project) /speckit.specify → Write a feature spec /speckit.clarify → Resolve ambiguities in the spec /speckit.plan → Generate technical plan + data model + contracts /speckit.analyze → Validate consistency across artifacts (read-only) /speckit.tasks → Generate phase-based task breakdown /speckit.checklist → Create quality checklists for the spec /speckit.implement → Execute implementation phase by phase /speckit.taskstoissues → Convert tasks into GitHub issues - Next step: "Run
/speckit.constitutionto complete your project constitution with project-specific principles, then/speckit.specifyto write your first feature spec."