sb-status

Report SpecBind lifecycle state and next actionable steps from CLI projections.

Updated Jul 17, 2026
One-click install
npx skills add https://github.com/Huruikagi/pc-build-planner --skill sb-status-huruikagi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sb-status
Source: https://github.com/Huruikagi/pc-build-planner/tree/main/.agents/skills/sb-status
Command: npx skills add https://github.com/Huruikagi/pc-build-planner --skill sb-status-huruikagi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams using SpecBind need a consistent, read-only answer to "where is this work now and what happens next" without manually inspecting spec.yaml, tasks.yaml, or roadmap files, which risks inconsistent or stale interpretations. ## Core Features & Use Cases - Milestone status reporting: Reads the active milestone projection to report stage, Task progress, recorded blockers, actionable items, and release blockers. - Single-Spec status reporting: Reads one named Spec's lifecycle state, Gate freshness, Task totals, next Tasks, and diagnostics. - Read-only boundary: Never approves, records progress, edits artifacts, or repairs state; it reports the recorded blocker condition and leaves remediation to the owning workflow. - Use Case: A developer asks "what should I do next on this milestone?" and receives a compact handoff covering completed work, blocked Tasks with recorded reasons, and the exact condition that must change. ## Quick Start Ask the assistant to report the current status of the active milestone or a named Spec using the sb-status skill.

Frequently Asked Questions about sb-status

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

FAQPage Schema
How do I check the status of a SpecBind milestone?▼

Run specbind milestone status to read the aggregate projection covering stage, Task progress, blockers, and release blockers. The skill interprets this projection and reports a compact handoff rather than a raw command transcript.

How do I report the lifecycle state of a single Spec?▼

Run specbind spec status <spec> to get lifecycle state, Gate freshness, Task totals, next Tasks, and diagnostics. Use specbind tasks list or tasks show only when blocked Task details materially explain what must be resolved.

Can sb-status fix or reopen blocked Tasks?▼

No. The skill is strictly read-only: it never approves, records progress, edits artifacts, or runs tasks reopen. It reports the recorded blocker condition and leaves remediation to the owning workflow.

Does a consistent state health result mean the Spec is correct?▼

No. State health: consistent only means no machine-checkable schema, lifecycle, or freshness diagnostics were found. Semantic alignment between Requirements, Design, Contract, and implementation is not evaluated by status reporting.

What happens when no milestone is active in SpecBind?▼

The CLI returns NO_CHANGE NO_ACTIVE_MILESTONE, which is not a failure. The skill reports that no milestone is active and stops rather than retrying or working around the read.