skills.rest
julien-m
julien-mCOMMUNITY
Explore all skills by this author →
GitHub

spec-status

Displays a read-only status overview of LiveSpec roadmap tiers and feature progress.

Updated Mar 11, 2026
Search Tags:#roadmap#feature tracking#status report#spec-driven development#json output#read-only#livespec
One-click install
npx skills add https://github.com/julien-m/livespec --skill spec-status-julien-m
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-status
Source: https://github.com/julien-m/livespec/tree/main/.agent-sync/skills/spec-status
Command: npx skills add https://github.com/julien-m/livespec --skill spec-status-julien-m

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using spec-driven development lose track of which features are drafted, planned, implemented, or stuck. This Skill gives an instant, factual snapshot of the entire LiveSpec project state without modifying any files. ## Core Features & Use Cases - Roadmap Parsing: Reads .specs/roadmap.md and counts checked/unchecked items per tier (MVP, Post-MVP, Future, Deferred). - Feature Scanning: Scans .specs/features/*/spec.md for status, plan, and implementation presence, then computes the next recommended action per feature. - Gap Detection: Flags stuck Draft features, features ready to implement, and pending deferred items. - Use Case: Run /spec-status --json in CI or an external dashboard to get a machine-readable summary of project progress, or run /spec-status in a session to decide which feature to advance next. ## Quick Start Ask the AI to run /spec-status to display the current roadmap and feature status overview of the project.

Frequently Asked Questions about spec-status

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

FAQPage Schema
How do I check the status of my LiveSpec project features?▼

Run /spec-status to display a summary of roadmap tiers and feature statuses. It reads .specs/project.md, roadmap.md, and each feature's spec.md, then shows counts, a feature table, and recommended next actions.

How to get machine-readable project status from LiveSpec?▼

Use the --json flag with /spec-status to output a structured JSON payload containing roadmap tiers, feature statuses, and detected gaps. Flags combine, so --json --roadmap outputs only the roadmap section as JSON.

Does /spec-status modify any project files?▼

No, /spec-status is strictly read-only. Its contract forbids creating or updating files in src/ or .specs/, and the definition of done requires that no files were created or modified during execution.

What happens if .specs directory does not exist when running spec-status?▼

The command stops immediately and displays the message that LiveSpec is not initialized, instructing you to run /spec-init first. This is treated as a blocked outcome with exit code 2.

How does spec-status decide the next action for each feature?▼

It uses a next action matrix based on feature status, plan presence, and implementation presence. For example, a Draft feature without a plan gets /spec-plan, while an Implemented feature with both gets /spec-check.

Related Skills

Explore More Software Engineering Skills→
unoplatformunoplatform
10.0k

speckit-clarify

Detects underspecified areas in feature specs and records targeted clarification answers.

Official
Advanced
councilofwizardscouncilofwizards
1

build-product

Coordinate feature specs through planning, implementation, and quality review.

Official
Advanced
zMynxxzMynxx

sdd-verify

Verifies SDD change implementations by executing tests and auditing spec compliance.

Community
Advanced
racecraft-labracecraft-lab
3

speckit-status

Summarize SpecKit roadmap and workflow status as a read-only dashboard.

Official
Intermediate