netanelavr/agent-kit / skills/kit-capture-lesson
kit-capture-lesson
VerifiedTurn a correction into a short written rule so it does not repeat. Use after steering, a repeated bug class, or “remember this”.
Capture Lesson
Write the smallest rule that would have blocked this mistake. Apply only after explicit approval.
What this is NOT
- Not domain terms or hard-to-reverse architecture (
kit-challenge-design→ CONTEXT / ADR) - Not a feature decision log (
kit-decisions) - Not choosing a thinner implementation (
kit-minimize) - Not a kit catalog audit (
kit-audit-skills) - Not a dump into CLAUDE.md / AGENTS.md / a new mega-skill
Flow
- Failure - one sentence: what the agent did or missed.
- Rule - 1-5 lines that would have blocked it. Concrete trigger + action. No essays.
- Surface - pick one:
| Put it here | When |
|---|---|
| Existing skill | The miss belongs to a paced workflow already in the catalog |
Project rules/ | It must fire without a slash (style, git, safety, loop gates) |
| New skill | Rare: a full opt-in flow that is not an always-on habit |
| User-global memory | Only if they ask for a personal habit across repos |
Prefer patching an existing skill or rule over adding a name.
- Show the exact patch. Stop. Wait for yes.
- After yes: smallest edit. If you add or rename a skill/rule, update
README.mdcatalogs and runkit-audit-skills. - Approved or not: if
.kit-evolve/lessons.mdexists and this correction has no line yet, append one in its header's format.
Constraints
- Generic: no employer names, private hosts, or work-only tools (
AGENTS.md) - Do not duplicate
kit-plan,kit-prove,kit-minimize,kit-strip-diff, orkit-delegate - Do not auto-apply. A proposed lesson that they reject is done.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |