SkillPublic
brief
Write or update `brief.md` for shaping. Use when asked to create a project or feature brief, a 1-2 pager, or to turn rough inputs into goals, non-goals, scope, risks, and open questions.
65
Quality
82%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Securityby
Passed
No findings from the security scan
Brief
Purpose
Start shaping with a concise brief.md.
Inputs
- Problem, why now, evidence, success.
- Appetite/timebox + constraints.
- Goals + non-goals.
- In/out scope (perimeter).
- Key flows + links (breadboard, risks, spikes).
- Top risks + unknowns.
- Open questions.
- If missing, use
ask-questions-if-underspecified.
Workflow
- Read any existing brief + inputs.
- Ask questions to clarify using
ask-questions-if-underspecifiedskill. - Draft
brief.md. - Keep 1-2 pages. Link out instead of dumping details.
- Ensure: problem alignment, goals/non-goals, perimeter, de-scope, risks/unknowns (<=10), open questions (<=10), shaping decision placeholder.
- Return updated
brief.md.
Output
brief.md
- Repository
marchatton/agent-skills
- Revision
a0eadb2
- Last updated
- First committed
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.