skills.rest
stharrold
stharroldCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

speckit-author

Generate spec.md and plan.md files for feature worktrees.

Updated Oct 22, 2025
Search Tags:#planning#documentation#feature development#specifications#interactive#technical design#implementation plan
One-click install
npx skills add https://github.com/stharrold/german --skill speckit-author
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-author
Source: https://github.com/stharrold/german/tree/main/.claude/skills/speckit-author
Command: npx skills add https://github.com/stharrold/german --skill speckit-author

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and templates (resource) components.

What problem does it solve?

This Skill streamlines the time-consuming and often inconsistent process of creating detailed technical specifications and implementation plans. It ensures that development starts with clear guidance, reduces ambiguity, and automatically integrates tasks into your TODO file, saving significant manual effort.

Core Features & Use Cases

  • Interactive Spec Generation: Guides you through a Q&A to create spec.md (detailed technical specification) and plan.md (implementation task breakdown) tailored to your feature.
  • BMAD Integration: Automatically detects and leverages existing BMAD planning documents (requirements.md, architecture.md, epics.md) to streamline Q&A and ensure consistency between planning and implementation.
  • Automated TODO Updates: Parses tasks from plan.md and automatically updates your TODO_*.md file, keeping your project tracking current without manual entry.
  • As-Built Documentation: Provides a mechanism to update original planning documents with "as-built" details, creating a valuable feedback loop for future projects.
  • Use Case: After creating a feature worktree, run create_specifications.py. The tool will ask targeted questions, generate a comprehensive spec.md and a detailed plan.md with tasks, and update your TODO file, allowing you to immediately start coding with a clear roadmap.

Quick Start

Example: Create specifications for a feature

(Run from within your feature worktree)

python .claude/skills/speckit-author/scripts/create_specifications.py
feature my-feature stharrold
--todo-file ../TODO_feature_20251024T143000Z_my-feature.md

Frequently Asked Questions about speckit-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate technical specifications and implementation plans for a feature?▼

Generate specifications by running the create_specifications.py script from your feature worktree. The tool guides you through interactive Q&A to produce spec.md with detailed technical requirements and plan.md with task breakdowns, then automatically updates your TODO file with parsed tasks.

Can I use existing planning documents to streamline spec generation?▼

Yes. The Skill detects BMAD planning documents (requirements.md, architecture.md, epics.md) in ../planning/<slug>/ and uses them to pre-populate answers, ensuring consistency between planning and implementation while reducing repetitive Q&A.

What gets created when I run the specification generator?▼

The tool creates a specs/<slug>/ directory containing CLAUDE.md, README.md, ARCHIVED/ folder, and updates TODO frontmatter with extracted tasks. All changes are committed to your feature branch automatically.

Does this work without existing BMAD planning documents?▼

Yes. The Skill supports both BMAD-enabled and BMAD-free workflows through interactive Q&A, so you can generate specs and plans from scratch if no prior planning artifacts exist.

How does this integrate with my TODO tracking system?▼

The tool parses tasks from generated plan.md and automatically updates your TODO_*.md file with structured entries, eliminating manual task entry and keeping project tracking synchronized with implementation plans.

Can I update planning documents after implementation to reflect actual decisions?▼

Yes. The Skill provides a mechanism to capture as-built details and update original planning documents (requirements.md, architecture.md, epics.md), creating a feedback loop that improves planning accuracy for future projects.

Related Skills

Explore More Software Engineering Skills→
Roeia1Roeia1
13

init

Create the .saga/ directory layout for epic and story workflows.

Community
Intermediate
KilimcininKorOgluKilimcininKorOglu
12

task-plan

Generate and manage task breakdowns from PRD documents with Git branches.

Community
Advanced
luanluan
4

commit

Create conventional Git commits and sync them with issue tracking systems.

Community
Intermediate
lidge-junlidge-jun
5

notion-spec-to-implementation

Transform Notion product specifications into structured implementation plans and tasks.

Community
Advanced