lets-make-a-skill
Use when creating or improving a skill that must both perform well on real prompts AND hold under rationalization pressure (discipline rules, process guardrails, workflows agents might shortcut under time or sunk-cost pressure).
- License 许可
- MIT
- 最近更新
- 2026-09-10
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- lets-make-a-skill
- description
- Use when creating or improving a skill that must both perform well on real prompts AND hold under rationalization pressure (discipline rules, process guardrails, workflows agents might shortcut under time or sunk-cost pressure).
- argument-hint
- <skill-name> [create|update|<directive>]
- user-invocable
- true
02 资源文件 11
- 参考文档evals/baseline-results/README.md6.1 KB
- 参考文档evals/baseline-results/scenario-1.md2.3 KB
- 参考文档evals/baseline-results/scenario-2.md3.3 KB
- 参考文档evals/baseline-results/scenario-3.md2.6 KB
- 参考文档evals/baseline-results/scenario-4.md3.0 KB
- 参考文档evals/pressure-scenarios.md3.4 KB
- 参考文档evals/with-skill-results/README.md5.0 KB
- 参考文档evals/with-skill-results/scenario-1.md2.3 KB
- 参考文档evals/with-skill-results/scenario-2.md1.6 KB
- 参考文档evals/with-skill-results/scenario-3.md2.3 KB
- 参考文档evals/with-skill-results/scenario-4.md2.8 KB
03 SKILL.md 正文
/skill-creator but using /super-duper-cat for worktree + parallel subagents, and /writing-skills for pressure testing.
Iron Law: this skill — and any skill built using this skill — ships only
after a baseline (no-skill agents) is observed shortcutting under pressure. A
passing baseline means no rationalization to address, which means no skill
needed. See evals/baseline-results/ for the canonical RED-phase evidence
captured during this skill's own bring-up.
Orchestration
The tensions between /skill-creator's quant eval loop and /writing-skills'
pressure tests collapse when RED fans out as a single parallel grid.
RED — one turn, parallel subagents
For each test case, dispatch two subagents in parallel (with-skill halves are skipped in RED because the skill does not exist yet):
| Permutation | Purpose |
|---|---|
| baseline × quant | /skill-creator pass-rate floor |
| baseline × pressure | /writing-skills rationalization capture |
Workspace:
<skill>-workspace/iteration-N/eval-<name>/
baseline/{quant,pressure}/
with-skill/{quant,pressure}/
Draft only after ALL baseline subagents return. Drafting early invalidates the iteration. "Too small to need a baseline" is a rationalization — the cost of one extra subagent is lower than the cost of a skill that does not address a real rationalization.
GREEN — draft, then re-fire the full grid
Dispatch 4 subagents per test case (baseline re-run included so iteration-N is a self-contained A/B). "Passes" requires BOTH:
- with-skill quant pass-rate is strictly greater than baseline quant pass-rate in the same iteration.
- with-skill pressure run produces no new rationalizations not already countered in the skill body.
A quant delta alone is not sufficient. A pressure pass alone is not sufficient. Both, or the iteration fails.
REFACTOR
- New rationalization in with-skill pressure → close loophole in skill body (per
/writing-skills). Do not add a quant assertion. - Quant regression → tighten skill body. Do not relax the assertion.
- Re-fire grid. Iterate until bulletproof.
Reports
benchmark.json+benchmark.mdfor the quant results. Generate these with whatever reporting tooling is available in your environment; if you use external/skill-creatorhelpers, treat them as external dependencies rather than repo-local scripts.rationalizations.md— markdown table produced by a grader subagent reading thepressure/dirs.- Optional viewer: use any available quant-results viewer in your environment. Keep the rationalization table as markdown next to the quant report.
Red flags — STOP if you catch yourself thinking
- "This skill is too small to need the pressure baseline" → run it anyway.
- "Quant improved, ship it" → check the pressure baseline first.
- "Serial is clearer than parallel subagents" → the grid IS the skill.
- "The partial baseline from yesterday is enough" → re-fire it in this iteration so the A/B is self-contained.
All of these are rationalizations captured from baseline runs. Each one already burned an iteration. Do not rediscover them.
04 同仓库更多 Skills
visual-aid
Use when the user asks for a quick visual aid, visual explainer, concept card, one-pager, poster, cheat sheet, infographic, visual summary, summary card, or mini explainer page — especially from input like a block of text, attached images, an attached song (lyrics/audio), a web link, a CSV/dataset, a math formula, a code snippet to walk through, a tutorial's steps, a timeline, or an A-vs-B comparison. Triggers include "make me a quick visual aid", "turn this into a one-pager / cheat sheet / explainer", "summarize this visually", "give me a visual of", "explain this on a single page", "make a concept card for", "whip up a page about", "build a mini page that shows", "something I can paste into a doc explaining X", or any request to render a topic/text/link/image-set/song/data into a standalone page. Prefer this skill over frontend-design when the ask is an explanatory single-file page (not a production UI), over playground when the output is static information display (not an interactive configurator), and over a Markdown/code answer when the user explicitly wants a *page* (HTML). Produces a single self-contained HTML file that opens on double-click without a server.
tesseract
Use when you've been poking at the same file, concept, or problem across many sessions and want to step outside time to see its whole arc — or when you want to leave a note for next-session-you. Triggers: 'I've been going in circles on X', 'what have I learned about X', 'what did past-me say about X', 'I keep rediscovering this'.
tdd
Invoke test-driven development as an explicit one-at-a-time micro-cycle — one test, one piece of functionality, refactor, then repeat for the next behavior
tdd-cat
TDD workflow with subagent-driven-development — /tdd composed with /cat, plus the A/B TDD execution-mode axis (split-phase vs micro-cycle) asked as a third question in /cat's combined pre-dispatch question
task-list
TaskCreate / TaskUpdate / render the current TaskList in response to `/task-list` (with or without flags). The skill body executes immediately on the syntax — no permission-seeking, no echoing the list back as plain text.
sync
Sync files between two local directories, repos, or git worktrees. Five modes (plan/interactive/push/pull/mirror), .gitignore-aware, Claude-workflow allowlist via --claude, dropbox-restore-style per-directory prompts.