Skill learn
Consolidate actionable lessons after another skill is used and required multiple correction rounds. Use this skill at task closure to extract concrete failures from the current conversation, propose safe incremental updates to the original skill files, show a diff first, and only apply changes after explicit user confirmation. Works for Claude and Codex skill workflows.From its SKILL.md
npx -y skills add rxdaozhang/skill-learn --skill skill-learnAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.3 KB, 619 tokens by cl100k_base, as published. Nobody here has run it
Skill Learn
Overview
Use this skill at the end of a task to improve the original skill that was just used. Extract concrete, evidence-based lessons from the current conversation and convert them into executable guidance for the target skill.
Workflow
- Resolve the target skill.
- Collect evidence from the current conversation only.
- Extract lessons in a strict schema.
- Propose incremental file updates.
- Show diff/patch before write.
- Apply changes only after explicit confirmation.
Resolve Target Skill
Follow this resolution order:
- Use explicit target path from user input if provided.
- Otherwise infer from the most recently used skill in the current context.
- If still ambiguous, ask one clarifying question and stop before proposing any write.
Never guess a target when two or more plausible skills exist.
Extract Lessons from Chat History
Use only the current conversation as evidence.
For each lesson, output this schema:
Rule: What to do next time.Anti-pattern: What failed or caused rework.Correction: Concrete action to prevent recurrence.Trigger: When this rule should be applied.Example(optional): A short concrete example.
Quality gate:
- Reject vague lessons such as "be better" or "be careful."
- Require concrete evidence from an observed iteration or correction.
- Prefer procedural wording that another agent can execute directly.
If evidence is insufficient, report that and do not propose a file write.
For reusable patterns and examples, consult:
references/lesson-patterns.md
Update Rules (Incremental Only)
When proposing updates to the target skill:
- Never rewrite the entire file.
- Prefer updating an existing anchored section such as
## Lessons Learned. - If no suitable anchor exists, append a bounded new section at the end.
- Keep unrelated sections unchanged.
- Keep
SKILL.mdconcise; move long canonical detail toreferences/skill-learn-lessons.mdin the target skill and add a pointer fromSKILL.md.
Do not delete or reorder unrelated guidance unless explicitly requested.
Diff-First Confirmation
Before any write:
- Present a readable diff/patch for each target file.
- Summarize the expected behavioral improvement.
- Ask for explicit confirmation.
Write only after confirmation. If confirmation is not provided, stop after delivering the proposal.
Failure Handling
Handle these cases explicitly:
- Target skill not found: ask for path or exact skill name.
- Multiple candidate targets: request disambiguation.
- No clear lessons with evidence: return "no high-confidence lesson updates."
- Requested change violates incremental policy: explain and offer an incremental alternative.
Output Format
Use this response structure:
Target SkillEvidence ExtractedProposed Lessons(Rule / Anti-pattern / Correction / Trigger / Example)Proposed File ChangesDiff PreviewConfirmation Request
What ships with it: 1 file
1.9 KB alongside SKILL.md
references/
- lesson-patterns.md1.9 KB
Gives 0 of the 12 instructions most learn study skills give in 619 tokens
Counted across 546 of the 573 authors here whose files we hold, read 2026-08-07
- Calculate the zone of proximal development before teachingin 25 of 546, across 8 files
- Produce self-contained HTML lessonsin 24 of 546, across 8 files
- Record user preferences in a notes filein 23 of 546, across 5 files
- Maintain a teaching workspace in the current directoryin 21 of 546, across 4 files
- Find high-quality resources before writing lessonsin 19 of 546, across 5 files
- Make lessons beautiful, short, and quickly completablein 19 of 546, across 3 files
- Create reusable components for lessonsin 19 of 546, across 5 files
- Create compressed reference documents for quick lookupin 19 of 546, across 3 files
- Update the mission file and records upon mission changesin 16 of 546, across 2 files
- Set min_dist to 0.0 for clustering preprocessingin 16 of 546, across 6 files
- Populate the mission file before teachingin 15 of 546, across 1 file
- Include interactive feedback loops in lessonsin 15 of 546, across 1 file
Said here and by no other author read
- resolve the target skill
- collect evidence from the current conversation
- extract lessons in the specified schema
- propose incremental file updates
- apply changes only after explicit confirmation
- reject vague lessons
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.