capture-learning

Capture investigation findings into dated knowledge base notes and updated procedures.

Updated Apr 16, 2025
One-click install
npx skills add https://github.com/damoke012/eks_code --skill capture-learning-damoke012
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capture-learning
Source: https://github.com/damoke012/eks_code/tree/main/.claude/skills/capture-learning
Command: npx skills add https://github.com/damoke012/eks_code --skill capture-learning-damoke012

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Findings from debugging sessions, incident resolutions, and PR reviews are often lost because they are never written down, forcing teams to re-investigate the same problems. This Skill structures the capture of what was learned immediately after an investigation concludes. ## Core Features & Use Cases - Four-question capture framework: Records what is now proven (with scope and date), which prior belief was wrong, whether a procedure changed, and whether a check could have caught the issue. - Routed destinations: Directs each kind of learning to the right place — dated notes in wip/<workstream>/, procedure updates in .claude/skills/<name>/SKILL.md, cross-session memory, or executable checks in scripts/ or hooks. - In-place correction style: Wrong claims are struck through and corrected rather than deleted, preserving the reasoning that produced them. - Use Case: After root-causing why etcd snapshots went stale in a QA environment, run this Skill to write a dated note, correct the stale belief in the existing docs, and add a lint check so the failure recurs as a red test instead of a repeated outage. ## Quick Start Ask the assistant to capture what was just learned from the investigation and write it up as a dated knowledge base note.

Frequently Asked Questions about capture-learning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document findings after a debugging session?▼

Answer four questions: what is now proven (with scope and date), which prior belief was wrong, whether a procedure changed, and whether a check could have caught it. Write the result as a dated note in the appropriate workstream directory.

How do I write a post-incident knowledge base note?▼

State the proven fact with a timestamp and scope, correct any wrong prior claim in place rather than deleting it, and end the note with sections for what was proven, what was tested and killed, and the traps.

When should a procedure change update a skill instead of a note?▼

Update the skill whenever a procedure will repeat, because a note nobody opens changes nothing. Editing the SKILL.md file turns a one-time finding into a durable behavior change for future sessions.

Why correct wrong claims in place instead of deleting them?▼

Striking and correcting a wrong claim preserves the reasoning that produced it, which is what prevents the next person from making the same mistake. Deleting it hides the trap and invites repetition.

What does the kb-lint script check for?▼

The kb-lint.sh script catches rotted notes: undated claims, references to files that no longer exist, and TODOs that outlived their tickets. Run it before finishing a capture to keep the knowledge base accurate.