OpenParable
Skip to content
← Back to skills

Add Lesson

Productivity
add-lesson

Add Lesson is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Add a new lesson learned to shared rules and sync to context files.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/add-lesson/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-lesson, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Add Lesson Skill

Add a new lesson learned to the shared rules.

Overview

When you discover a bug, mistake, or useful pattern, use this skill to document it so all agents learn from it.

Usage

/add-lesson

Prerequisites

  • Access to shared-rules/ and permission to run scripts/sync-rules.py.

Lesson Template

### YYYY-MM-DD - Brief Title

- **Issue**: What went wrong or was discovered
- **Root Cause**: Why it happened
- **Fix**: How it was fixed
- **Prevention**: Rule or check to prevent recurrence
- **Applies To**: all | claude | cursor | gemini
- **Files Changed**: List of affected files

Process

  1. Gather information:

    • What was the issue?
    • What caused it?
    • How was it fixed?
    • How can we prevent it?
  2. Add to lessons file:

    • Open shared-rules/lessons-learned.md
    • Add new entry at TOP of "Recent Lessons" section
    • Use the template format
  3. Run sync:

    python scripts/sync-rules.py
    
  4. Verify propagation:

    • Check CLAUDE.md updated
    • Check timestamp

Example

### 2026-01-22 - Task Tool Token Efficiency

- **Issue**: Spawning Claude workers via subprocess was expensive (~13k tokens overhead)
- **Root Cause**: Full context duplication to each subprocess
- **Fix**: Use native Task tool with context filtering
- **Prevention**: Always prefer Task tool over subprocess for Claude workers
- **Applies To**: claude
- **Files Changed**:
  - `.claude/skills/implement-task/SKILL.md`
  - `CLAUDE.md`

Categories

Lessons should be categorized by:

  • all - Applies to all agents
  • claude - Claude-specific
  • cursor - Cursor-specific
  • gemini - Gemini-specific

Archiving

After 30 days or when list gets long:

  • Move old lessons to "Archived Lessons" section
  • Keep for historical reference

Outputs

  • Updated shared-rules/ content and synced context files (e.g. CLAUDE.md).

Error Handling

  • If sync fails, do not proceed; resolve and rerun scripts/sync-rules.py.
  • If lesson template is incomplete, request the missing fields before adding.

Related Skills

  • /sync-rules - Sync shared rules into context files