OpenSkillIndex← back to search
claude-code

Claude-skill-registry-data manage-lessons

Manage lessons learned with global scope

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry-data
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/manage-lessons" ~/.claude/skills/majiayu000-claude-skill-registry-data-manage-lessons && rm -rf "$T"
manifest: data/manage-lessons/SKILL.md
source content

Lessons Learned Skill

Manage lessons learned with global scope. Stores lessons as markdown files with key=value metadata headers.

What This Skill Provides

  • Create lessons from errors or discoveries
  • Query lessons by component, category, or applied status
  • Update lesson metadata
  • Global scope (not plan-specific)

When to Activate This Skill

Activate this skill when:

  • Documenting a lesson from an error
  • Querying applicable lessons for a component
  • Marking lessons as applied

Storage Location

Lessons are stored globally:

.plan/lessons-learned/
  2025-12-02-001.md
  2025-12-02-002.md
  ...

File Format

Markdown with key=value metadata header:

id=2025-12-02-001
component=maven-build
category=bug
applied=false
created=2025-12-02

# Build fails with missing dependency

When running `mvn clean install`, the build fails with a missing
dependency error for `jakarta.json-api`.

## Solution

Add the dependency explicitly to pom.xml:

```xml
<dependency>
    <groupId>jakarta.json</groupId>
    <artifactId>jakarta.json-api</artifactId>
</dependency>

Impact

This affects all projects using jakarta.json without explicit dependency.


### Metadata Fields

| Field | Description |
|-------|-------------|
| `id` | Unique identifier (date-sequence) |
| `component` | Component that lesson applies to |
| `category` | bug, improvement, anti-pattern |
| `applied` | Whether lesson has been applied (true/false) |
| `created` | Creation date |
| `bundle` | Optional bundle reference |

---

## Operations

Script: `plan-marshall:manage-lessons:manage-lesson`

### add

Create a new lesson.

```bash
python3 .plan/execute-script.py plan-marshall:manage-lessons:manage-lesson add \
  --component maven-build \
  --category bug \
  --title "Build fails with missing dependency" \
  --detail "When running mvn clean install..." \
  [--bundle planning]

Parameters:

  • --component
    (required): Component that lesson applies to
  • --category
    (required): 
    bug
    , 
    improvement
    , or 
    anti-pattern
  • --title
    (required): Lesson title
  • --detail
    (required): Lesson detail/content
  • --bundle
    : Optional bundle reference

Output (TOON):

status: success
id: 2025-12-02-001
file: 2025-12-02-001.md
component: maven-build
category: bug

update

Update lesson metadata.

python3 .plan/execute-script.py plan-marshall:manage-lessons:manage-lesson update \
  --id 2025-12-02-001 \
  [--applied true|false] \
  [--component new-component] \
  [--category bug|improvement|anti-pattern]

Parameters:

  • --id
    (required): Lesson ID to update
  • --applied
    : Set applied status (true/false)
  • --component
    : Update component name
  • --category
    : Update category

Output (TOON):

status: success
id: 2025-12-02-001
field: applied
value: true
previous: false

get

Get a single lesson.

python3 .plan/execute-script.py plan-marshall:manage-lessons:manage-lesson get \
  --id 2025-12-02-001

Output (TOON):

status: success
id: 2025-12-02-001
component: maven-build
category: bug
applied: false
created: 2025-12-02
title: Build fails with missing dependency

content: |
  When running `mvn clean install`...

list

List lessons with filtering.

python3 .plan/execute-script.py plan-marshall:manage-lessons:manage-lesson list \
  [--component maven-build] \
  [--category bug] \
  [--applied true|false]

Parameters:

  • --component
    : Filter by component name
  • --category
    : Filter by category (
    bug
    , 
    improvement
    , 
    anti-pattern
    )
  • --applied
    : Filter by applied status (true/false)

Output (TOON):

status: success
total: 5
filtered: 2
lessons:
  - id: 2025-12-02-001
    component: maven-build
    category: bug
    applied: false
    title: Build fails with missing dependency
  - id: 2025-12-02-002
    component: plan-files
    category: improvement
    applied: true
    title: Add validation for plan_id format

from-error

Create lesson from error context (JSON).

python3 .plan/execute-script.py plan-marshall:manage-lessons:manage-lesson from-error \
  --context '{"component":"maven-build","error":"Missing dependency","solution":"Add explicit dep"}'

Parameters:

  • --context
    (required): JSON object with error context 
    • component
      : Component name (defaults to "unknown")
    • error
      : Error message (required)
    • solution
      : Optional solution description

Output (TOON):

status: success
id: 2025-12-02-003
created_from: error_context

Scripts

Script: 

plan-marshall:manage-lessons:manage-lesson

CommandParametersDescription
add
--component --category --title --detail [--bundle]
Create new lesson
update
--id [--applied] [--component] [--category]
Update lesson metadata
get
--id
Get single lesson
list
[--component] [--category] [--applied]
List with filtering
from-error
--context
Create from JSON error context

Categories

CategoryWhen to Use
bug
Script is broken or produces wrong results
improvement
Script works but could be better
anti-pattern
Script was misused or documentation unclear

Integration Points

With plan-execute

When errors occur during execution, create lessons to document the issue and solution.

With plugin-doctor

Apply lessons to fix recurring issues in marketplace components.