About goal-design
A skill that turns a project brief into a concise, verifiable `/goal` prompt for an agent. It specifies checks, evidence, an effort budget, reviewer sign-off, and conditions for stopping as blocked.
Key features
- 01Read the brief and referenced material
- 02Draft a five-to-eight-sentence `/goal` prompt
- 03Specify verifiable checks and proof
- 04Set an effort budget and stop conditions
- 05Require reviewer sign-off before a pull request
Use cases
- 01Convert a change request into an agent goal
- 02Define evidence needed to verify completion
- 03Bound work with budgets and blocking conditions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ owainlewis/ blueprint --skill goal-designAfter installing, type/goal-designin Claude Code to confirm it loaded.
Details
From the project READMEGoal Design
- Read the brief and anything it references. Ask only when the goal cannot be checked from the input.
- Write one plain prompt starting with
/goal, 5-8 sentences: what to read first, what to change, what checks must pass, what proof to report, an effort budget, and when to stop as blocked. - Return the prompt first. Add a note after only when useful.
Rules
- The completion condition must be provable from the agent's own output. Name the exact command and expected result; goal evaluation reads the session, it does not run checks itself.
- Checks are a gate, not a suggestion. Concrete proof: command results, links, files, screenshots.
- Always include a budget: a turn, iteration, or time limit.
- Require reviewer sign-off before PR, and a check of each acceptance criterion when criteria exist.
- Include stop conditions: unclear change, missing secrets or permission, repeating failure, duplicate PR, scope growing beyond the request.
- No giant Markdown docs, scheduled jobs, or external automation unless asked.
Shape
/goal Finish <result>. Before changing anything, read <sources>. Change only <allowed files or behavior>. Make the smallest complete change, add or update tests, ask another reviewer to check it, and run <checks>. Do not open a PR or report done until <proof> shows <expected output>. Stop after <budget>, or if <stop condition>, and report what blocks the work.
Comments
Markdown supported