Menu
Use when an artefact is clear but has open decisions to work through. Convergent, decision-driven shaping for Designs, Plans, Tasks, Reports, Research, Presentations, Printables, Mockups.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Identify changed code and dispatch reuse, quality, and efficiency reviewer agents in parallel; return the raw findings list.
Review changed code for reuse, quality, and efficiency, and produce a triaged list of findings (no edits). Use after writing code, for simpler code with fewer bugs and better performance.
Provides guidance on good software design principles, with trade-off calibration, examples, and common failure modes. Applies when making decisions while writing, designing, or refactoring code, or evaluating trivial code for clarity, maintainability, and common mistakes.
Reviews code with a team against established software design principles, and returns triaged findings (no edits). Use when evaluating code, or after writing or refactoring complex code, systems or technical designs: for code that is clearer, easier to maintain, and avoids common mistakes.
Shared setup for shaping sessions. Determines if an artefact exists or needs creating, creates it if needed, starts the transcript, reads the type taxonomy. Called by the parent router or by any sub-skill invoked directly.
Shape an artefact through structured Q&A. Routes to the right sub-skill: brainstorm (new/unclear artefacts), refine (open decisions), or discover (exploration-driven artefacts like People and Ideas).
| name | shaping:refine |
| description | Use when an artefact is clear but has open decisions to work through. Convergent, decision-driven shaping for Designs, Plans, Tasks, Reports, Research, Presentations, Printables, Mockups. |
Works through open decisions one at a time until the artefact meets its type's shaping bar.
If you don't have an artefact path and transcript path from the parent skill or brainstorm, read and follow shaping/assess first to set up the session.
Review the artefact's open questions or decision table. Skip what's already resolved. Inventory what remains. For resumptions, the artefact is the source of truth — not old transcripts.
Q3 [D2, D4]shaping/assessbrain_edit, update the decision table, record the turn in the transcript## Shaping section: internal consistency, completeness, clarity, links/provenance.ready?" Set status via brain_edit. Signal: "Fully shaped — [artefact] is ready."