Self Improvement
Overview
Capture corrections, command failures, tool surprises, missing capabilities, and better approaches as durable project learnings. Use this skill when a task reveals reusable knowledge that should prevent future mistakes or improve agent behavior.
When to Use
- A command, API call, or integration fails in a non-obvious way.
- The user corrects an assumption or gives project-specific guidance.
- A recurring problem suggests a reusable rule, checklist, or automation.
- A workaround should be promoted into
CLAUDE.md, AGENTS.md, or another project memory file.
Workflow
- Decide whether the event is a learning, error, or feature request.
- Create or update
.learnings/LEARNINGS.md, .learnings/ERRORS.md, or .learnings/FEATURE_REQUESTS.md.
- Include a short summary, context, priority, affected area, suggested action, and related files.
- Search existing entries before adding a new one; link related entries with
See Also.
- Promote broadly useful items into project guidance after they are verified or recur.
Entry Template
## [LRN-YYYYMMDD-001] concise-category
**Logged**: ISO-8601 timestamp
**Priority**: low | medium | high | critical
**Status**: pending
**Area**: frontend | backend | infra | tests | docs | config
### Summary
One-line description.
### Details
What happened, what was misunderstood, and what is now known.
### Suggested Action
Specific prevention or improvement.
### Metadata
- Source: conversation | error | user_feedback | investigation
- Related Files: path/to/file.ext
- Tags: tag1, tag2
- See Also: optional related IDs
Promotion Rules
Promote a learning when it applies across multiple tasks, prevents repeated mistakes, documents an important project convention, or has been verified by a fix. Keep promoted guidance short and action-oriented.
Source Notes
Adapted from the SkillsMP self-improvement skill, selected because it is highly starred on SkillsMP and fills a library gap around persistent agent learning workflows.
1---2name: self-improvement3description: Capture corrections, command failures, tool surprises, missing capabilities, and better approaches as durable project learnings. Use this skill when a task reveals reusable knowledge that should prevent future mistakes or improve agent behavior.4---56# Self Improvement78## Overview9Capture corrections, command failures, tool surprises, missing capabilities, and better approaches as durable project learnings. Use this skill when a task reveals reusable knowledge that should prevent future mistakes or improve agent behavior.1011## When to Use12- A command, API call, or integration fails in a non-obvious way.13- The user corrects an assumption or gives project-specific guidance.14- A recurring problem suggests a reusable rule, checklist, or automation.15- A workaround should be promoted into `CLAUDE.md`, `AGENTS.md`, or another project memory file.1617## Workflow181. Decide whether the event is a learning, error, or feature request.192. Create or update `.learnings/LEARNINGS.md`, `.learnings/ERRORS.md`, or `.learnings/FEATURE_REQUESTS.md`.203. Include a short summary, context, priority, affected area, suggested action, and related files.214. Search existing entries before adding a new one; link related entries with `See Also`.225. Promote broadly useful items into project guidance after they are verified or recur.2324## Entry Template25```markdown26## [LRN-YYYYMMDD-001] concise-category2728**Logged**: ISO-8601 timestamp29**Priority**: low | medium | high | critical30**Status**: pending31**Area**: frontend | backend | infra | tests | docs | config3233### Summary34One-line description.3536### Details37What happened, what was misunderstood, and what is now known.3839### Suggested Action40Specific prevention or improvement.4142### Metadata43- Source: conversation | error | user_feedback | investigation44- Related Files: path/to/file.ext45- Tags: tag1, tag246- See Also: optional related IDs47```4849## Promotion Rules50Promote a learning when it applies across multiple tasks, prevents repeated mistakes, documents an important project convention, or has been verified by a fix. Keep promoted guidance short and action-oriented.5152## Source Notes53Adapted from the SkillsMP `self-improvement` skill, selected because it is highly starred on SkillsMP and fills a library gap around persistent agent learning workflows.
michaelschecht