speck-help

Interpret Speck artifacts to answer questions about specs, plans, and tasks.

4|1|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/nprbst/speck --skill speck-help
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speck-help
Source: https://github.com/nprbst/speck/tree/main/.claude/skills/speck-help
Command: npx skills add https://github.com/nprbst/speck --skill speck-help

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort of interpreting complex project specifications, plans, and task lists. It allows developers to quickly grasp feature requirements, implementation status, and architectural decisions without sifting through documents, saving time and reducing misunderstandings.

Core Features & Use Cases

  • Artifact Interpretation: Automatically understands and extracts information from spec.md, plan.md, and tasks.md files.
  • Natural Language Q&A: Ask questions about requirements, progress, architecture, user stories, and more, receiving direct and structured answers.
  • Workflow Guidance: Provides actionable recovery guidance for incomplete files and suggests appropriate slash commands for creating or modifying Speck artifacts.
  • Use Case: Instead of manually searching spec.md for user stories or checking tasks.md for pending work, simply ask, "What user stories are in this spec?" or "What tasks are pending for feature 005?" and get an instant, structured response.

Quick Start

What user stories are in this spec?

Frequently Asked Questions about speck-help

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

FAQPage Schema
How do I quickly find information in my project's spec, plan, and task files?

Speck-help interprets spec.md, plan.md, and tasks.md files to answer questions about requirements, progress, and architecture in natural language. Ask directly about feature scope, user stories, pending tasks, or implementation status and receive structured answers without manual document searching.

Can I use this to understand requirements and user stories from documentation?

Yes. Speck-help extracts and explains user stories, requirements, and architectural decisions from your Speck artifacts. Query by feature number, user story, or architectural component to get instant, structured responses about what's specified and planned.

What should I do if my spec.md or tasks.md files are incomplete?

Speck-help provides recovery guidance for incomplete files and recommends appropriate slash commands to create or modify Speck artifacts. It classifies file states and suggests next steps to bring documentation into proper structure.

How do I track task progress and pending work across my project?

Query tasks.md through Speck-help to identify pending work, completed tasks, and blockers by feature or workflow stage. The Skill maintains session context and supports multi-repo awareness, so progress tracking works across your project structure.

Does this work with multiple repositories or worktrees?

Yes. Speck-help implements multi-repo and worktree awareness, allowing you to interpret Speck artifacts consistently across separate repositories and working trees in a single session.

What's the difference between using this and manually reading specification documents?

Speck-help eliminates manual searching through long documents by accepting natural-language questions and returning targeted, structured answers about feature scope, implementation status, and workflow artifacts in seconds.