What problem does it solve?
Creating agent skills without clear, tight scope definitions leads to bloated, hard-to-route skills that fail to meet user needs. This Skill eliminates that ambiguity by guiding users through a structured scoping workflow to produce valid, actionable skill-brief.yaml files that drive downstream skill compilation.
Core Features & Use Cases
- Guided Intent Gathering: Collects target repository info, user intent, and scope hints through interactive or headless prompts.
- Automated Target Analysis: Detects repository language, structure, public API surface, and version automatically for supported languages.
- Collaborative Scope Definition: Walks users through selecting scope types (full-library, public-api, component-library, etc.) and defining include/exclude boundaries.
- Validated Brief Generation: Outputs a schema-valid skill-brief.yaml that serves as the input contract for the create-skill compilation workflow.
- Use Case: A developer building a skill for the Stripe API uses this tool to define a narrow scope covering only payment intents and subscriptions (excluding internal HTTP plumbing), analyze the Stripe repo's exports, and generate a brief that create-skill uses to build the final SKILL.md.
Quick Start
Use the skf-brief-skill to generate a validated skill-brief.yaml for the target repository or documentation set you want to convert into an agent skill, following the guided prompts to define scope and output the required brief file.