learning-from-experience
Skill33 starsChanged 16 days agoMITView on GitHub
Turns incidents, near misses, bad handoffs, review surprises, escaped bugs, and signals from real use into lasting fixes to your safeguards. Use after something went wrong or nearly did and a future safeguard should change. Do not use during a live incident, which comes first, or to blame someone.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- game1991/claude-skillstheir own version, first seen Oct 11, 2026
- game1991/awesome-skillstheir own version, first seen Sep 14, 2026
- prime-radiant-inc/study-skillstheir own version, first seen Sep 9, 2026
- agrivisionai/claude-skillstheir own version, first seen Jul 14, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- prime-radiant-inc/study-skills★ 9same name
- agrivisionai/claude-skills★ 1same name
- game1991/awesome-skills★ 0same name
- game1991/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository34 other files it gives its agents.
- AGENTS.mdAGENTS.md
- challenge/AGENTS.mdAGENTS.md
- challenge/CLAUDE.mdCLAUDE.md
- CLAUDE.mdCLAUDE.md
- breaking-down-the-workSkill
- briefing-an-agentSkill
- checking-factsSkill
- checking-legal-and-safety-wordingSkill
- checking-release-readinessSkill
- checking-source-claimsSkill
- checking-what-a-change-affectsSkill
- choosing-what-to-controlSkill
- closing-stale-packetsSkill
- creating-change-recordsSkill
- deciding-who-decidesSkill
- declaring-intentSkill
- double-checking-before-actingSkill
- handing-off-workSkill
- organizing-project-foldersSkill
- proving-claimsSkill
- questioning-attitudeSkill
- rating-change-riskSkill
- recording-a-known-good-versionSkill
- recording-what-an-agent-didSkill
- reporting-shared-defectsSkill
- responding-to-incidentsSkill
- reviewing-code-qualitySkill
- running-a-review-panelSkill
- staying-on-missionSkill
- stress-testing-agent-changesSkill
- tracking-deficienciesSkill
- using-nuclear-gradeSkill
- verifying-final-artifactsSkill
- vetting-outside-code-and-modelsSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
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 46
Do not close the lesson with just regret or an explanation when a real control could change instead.
- Distinctive: line 60
Every finding has an action, an owner, and either evidence or a reason it was closed.
≈ “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
Learning From Experience
Overview
Lessons from real operation (OPEX) only help if they change future work. So treat agent mistakes, near misses, review surprises, sloppy analysis, and support tickets as feedback. Each one shows you where a control was weak. A control is anything that steers behavior, like a test, a checker, a rule, or a permission limit. Use the lesson to make that control stronger.
No-blame applies to honest error and at-risk slips: the point is to fix the control, not the person or the model. It does not extend to a willful violation — knowingly disabling a control, fabricating a passing result, or routing around a required gate. Surface that and correct it as a finding; never file it as "just a mistake," and never normalize it (Charter Art. 3, 19). A bypassable gate is also its own weak control, so the lesson fixes both the violation and the gate that allowed it.
Decision contract
- Claim checked: the event is stated as actual-versus-standard with a root cause and weak control named, and closes with an owned, verified control fix or a deliberate waiver saying why no fix was needed.
- Artifact observed: the event, near miss, or operating signal and the control it touched -> an OPEX record with the finding, action, owner, and evidence or close-out reason.
- Decision affected: block -- whether a durable control (test, template, prompt, monitor, checker, or baseline) is updated, or the lesson is explicitly waived with a reason.
- Failure class: unlearned-lesson (a fix with no control change, or a record closed with regret instead of a fix).
- Next action: assign an owner and a recheck trigger; a repeated weak control escalates to a second independent reviewer.
When to Use
- A bad handoff, a wrong-file edit, a made-up claim, an agent going past its allowed tools, a bug that escaped to users, or a surprise in review happened.
- Users or operators misread a release, a public claim, a runbook, a template, or an approved version.
- A past change record, skill, command, test, checker, monitor, or template failed to steer behavior the way it should have.
- A change to the rules or sources produced new text but no lasting change to a control.
When Not to Use
- The event has no lesson that would repeat, and no control could reasonably change.
- You must contain a live incident first; analyze it after.
- The request is to blame someone rather than improve a control.
Inputs
- The event, near miss, review surprise, operating signal, or user feedback.
- The change record, approved version, file, skill, command, test, checker, monitor, or doc it affected.
- The evidence, the impact, the quick fix you already made, and the chance it happens again.
Process
- State the actual condition in plain words, no blame, and name the standard or expected condition it fell short of. Separate an honest error or at-risk slip (fix the control) from a willful violation — a knowingly bypassed gate, a disabled control, a fabricated result (surface and correct it, keep an owner for closure, and never normalize it).
- Name where it is red — the gap between actual and standard — then find the root cause, not the symptom, and the weak or missing control and which approved version or file it touched.
- Pick a lasting fix: update a basis, a test, a checker, a template, a skill, a command, a doc, a monitor, a threshold, or an approved version.
- Do not close the lesson with just regret or an explanation when a real control could change instead.
- Give the correction an owner, then verify the improvement — or close the lesson on purpose and say why no fix was needed.
- Feed the lesson into future questioning, planning, verification, and handoffs.
This actual-vs-standard, root-cause, owner, verify structure keeps a retro from drifting into a vague "what went well / what could improve." A standing deficiency that will outlive this lesson belongs in the deficiency register (tracking-deficiencies).
Outputs
- An OPEX record (a lessons-from-operation record) or an issue entry.
- A lasting control fix, or a clear reason why no fix is warranted.
- A trigger to re-verify or re-record the approved version when a controlled item changed.
Verification
- Every finding has an action, an owner, and either evidence or a reason it was closed.
- Future agents can find the lesson before they repeat the pattern.
- The lesson updates a controlled item, or explains why no update is needed.
Escalation
- Escalate if the event touched users, data, security, credentials, releases, public claims, or repeated agent power.
- A defect found in a shared or supplied artifact (a shared prompt, skill, dependency, model, eval, or template) carries an outward duty: evaluate who relies on it and notify the downstream teams, agents, or releases, not just fix your own copy. The inward control fix and the outward notice are separate obligations.
- Require a second, independent reviewer when the same weak control shows up more than once.
Common Rationalizations
- "The agent just made a mistake." Ask what prompt, context, checker, review, or power limit let it happen.
- "We fixed the bug." A fix with no lesson can come back through another path.
- "No one was harmed." A near miss is a cheaper warning than a real incident.
- "No-blame means no accountability." No-blame covers honest error, not a knowingly bypassed gate or a fabricated result. Surface the violation, fix the control that let it happen, and keep an owner for closure.
Red Flags
- The OPEX record has no lasting fix and no reason it was closed.
- The lesson is stuck in chat history.
- The record blames one person or one model as the sole cause.
- A knowingly bypassed gate or a fabricated result is filed as "just a mistake," so the violation goes unowned and the bypassable gate is never fixed.
- The follow-up has no owner and no trigger.
Prompt
Create a Nuclear-grade OPEX record (lessons from real operation).
Inputs:
- event or near miss:
- affected packet / baseline / artifact:
- evidence:
- impact:
- immediate correction:
- weak or missing control:
- candidate durable update:
- owner:
- due date or trigger:
Produce a no-blame OPEX record (no-blame covers honest error, not a willful violation like a knowingly bypassed gate, disabled control, or fabricated result — surface those as findings, never file them as mistakes). Each finding must either change a lasting control or be closed with a clear reason why not.Source-lineage note
This skill is an original software-workflow translation of operating experience, post-job review, reporting errors and near misses, change management, independent oversight, and no-blame learning practices from DOE-HDBK-1028-2009, with the outward defect-reporting duty informed by 10 CFR Part 21 (§21.21), as public source lineage. It does not create DOE compliance, formal assurance, safety, security, certification, or regulatory adequacy.
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.

