sb-discovery

Classify change requests into confirmed Spec and milestone scope boundaries.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams using SpecBind need a disciplined way to decide which durable specification boundaries a change request belongs to before any lifecycle state is mutated. This Skill turns a change request or an explicit Source Collection into a confirmed scope proposal, preventing scope from being built on guesses or applied without user approval. ## Core Features & Use Cases - Scope classification: Classifies each part of a request as Direct work, an existing Spec update, or a new Spec, based on ownership rather than size, and names the gates that must be invalidated. - Source Collection providers: Acquires complete read-only snapshots from explicitly supplied local files or a GitHub Milestone (OWNER/REPO plus number), with full source coverage reporting and version-shaped release label binding. - Confirmation-first mutation: Presents a four-field confirmation payload (work items, new Specs, gate invalidations, dependencies) and performs CLI-driven rewinds, milestone creation or scope updates, Brief authoring, and adapter-directed checkpoints only after explicit approval. - Use Case: A maintainer supplies acme/widgets Milestone 3 and asks to plan the release; the Skill reads every Issue, proposes the work-item decomposition, and after confirmation creates the milestone scope, writes per-Spec Briefs, and binds the release label. ## Quick Start Ask the assistant to use sb-discovery to classify your change request or a supplied GitHub Milestone into milestone scope and confirm the proposed work items before anything is changed.

Frequently Asked Questions about sb-discovery

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

FAQPage Schema
How do I turn a change request into milestone scope with SpecBind?▼

Invoke sb-discovery with the request. It reads milestone status, Spec list, and all steering documents, classifies each part as Direct, existing Spec update, or new Spec, then presents a confirmation payload. Only after your explicit approval does it run gate invalidations and milestone create or update-scope via the specbind CLI.

How do I plan work from a GitHub Milestone?▼

Supply the exact OWNER/REPO plus a Milestone number, or the canonical URL https://github.com/OWNER/REPO/milestone/NUMBER. The Skill performs one read-only acquisition of every assigned Issue, classifies them with full source coverage, and can bind a version-shaped Milestone title as the release label after confirmation.

Does Discovery confirm scope before changing anything?▼

Yes. The invocation itself is never treated as confirmation. The Skill must present the four-field payload (work items, new Specs, gate invalidations, dependencies) plus source coverage when applicable, and only a later user reply authorizes any lifecycle or artifact mutation.

Can I use a local folder of notes as Discovery input?▼

Only when you explicitly supply the file or directory. The local-files provider verifies every entry is a Git-tracked, readable UTF-8 ordinary file inside the project root, inventories the complete collection, and stops on any unreadable item rather than continuing with partial coverage.

What are the limitations of the Discovery phase?▼

Discovery never authors requirements, designs, roadmap files, or spec.yaml directly; those belong to later phases or the CLI. It also cannot remove scoped Specs, abandon milestones, or commit to satisfy clean-repository requirements, and it stops to ask instead of improvising equivalents.