AGENT SKILL

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

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.md for the quant results. Generate these with whatever reporting tooling is available in your environment; if you use external /skill-creator helpers, treat them as external dependencies rather than repo-local scripts.
  • rationalizations.md — markdown table produced by a grader subagent reading the pressure/ 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

laurac8r
laurac8r/claude-damn

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.

前端开发视觉设计
★ 3
laurac8r
laurac8r/claude-damn

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'.

★ 3
laurac8r
laurac8r/claude-damn

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

★ 3
laurac8r
laurac8r/claude-damn

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

★ 3
laurac8r
laurac8r/claude-damn

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.

★ 3
laurac8r
laurac8r/claude-damn

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.

★ 3