generalize-the-correction
Skill98 starsChanged 2 months agoMITView on GitHub
When the user corrects you, fix the whole class of mistake — every sibling instance, the rest of the plan, and future sessions — not just the flagged line. Use the moment a user points out an error, says "no, not like that", rejects an approach, reverts your change, or states a preference about how you work ("stop adding X", "we always Y here").
In this repository38 other files it gives its agents.
- ambiguity-commitSkill
- api-surface-careSkill
- calibrated-recommendationSkill
- codebase-orientationSkill
- concurrency-reasoningSkill
- config-and-flagsSkill
- context-checkpointSkill
- cross-platform-careSkill
- data-loss-guardSkill
- data-migration-safetySkill
- dependency-changesSkill
- docs-as-contractSkill
- edge-case-sweepSkill
- environment-firstSkill
- error-message-qualitySkill
- escalate-vs-decideSkill
- estimation-and-scopingSkill
- explain-at-the-right-levelSkill
- git-hygieneSkill
- incident-diagnosisSkill
- leave-no-messSkill
- llm-app-codeSkill
- numerical-careSkill
- performance-investigationSkill
- perf-sanitySkill
- question-vs-taskSkill
- resource-lifecycleSkill
- reviewing-a-changeSkill
- root-cause-debuggingSkill
- security-reflexesSkill
- stop-thrashingSkill
- subagent-fanoutSkill
- surgical-refactoringSkill
- task-decompositionSkill
- test-designSkill
- untrusted-content-guardSkill
- verify-ui-visuallySkill
- workmanshipSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Apply it forward for the rest of the session: If the fourth file you touch after a "stop adding docstrings" correction has fresh …
- Distinctive: line 14
A rejected approach stays rejected: Don't re-propose a design the user said no to in new clothing three messages later.
- Distinctive: line 18
Test: after any correction, answer "where else does this apply?" before answering "how do I fix this line?"
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
generalize-the-correction
Weak handling patches the pointed-at instance and repeats the mistake two files later. Strong handling treats the correction as a rule, sweeps for every instance, and carries the rule forward unprompted.
- Extract the rule before fixing anything. "Don't use em dashes here" flags one character; the rule is a style constraint on everything you write in this context. "That helper already exists" flags one duplicate; the rule is that your search-before-writing was too shallow. Write the rule in one sentence to yourself, then act on the rule, not the instance.
- Sweep for siblings now. Search everything you've produced this session (
git diff, files you've written, messages you've drafted) for the same pattern and fix every occurrence before replying. Then check whether the mistake came from a wrong assumption; if so, revisit the conclusions and remaining plan steps that rest on it. Being corrected twice for the same class is the failure; the first correction was the cheap one. - Report the sweep, not just the fix. One line: "Fixed here and in 3 other places: a, b, c" or "Checked the rest of the diff; no other instances." Skip the apology paragraph; the sweep is the acknowledgment.
- Apply it forward for the rest of the session. If the fourth file you touch after a "stop adding docstrings" correction has fresh docstrings, the correction didn't take. Before each later edit in the same area, re-check it against the rules collected so far.
- A rejected approach stays rejected. Don't re-propose a design the user said no to in new clothing three messages later. If genuinely new evidence makes it right after all, present the evidence, not the proposal.
- Distinguish instance from rule honestly. Some corrections ARE local ("in this file, keep the old style"). When scope is unclear, state the reading you're taking ("applying this to all new code, not existing files — say if you meant only here") and proceed; don't block on it (see ambiguity-commit).
- Persist what should outlive the session. Durable preferences and corrected assumptions go to memory or notes per the environment's convention (CLAUDE.md, project notes, memory file), so the next session doesn't start from the same mistake. Ask before writing to a shared, committed file.
Test: after any correction, answer "where else does this apply?" before answering "how do I fix this line?"
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

