lesson-resurfacelisted
Install: claude install-skill tansuasici/claude-code-kit
# Lesson Resurface
## Core Rule
Given a short task summary, return a ranked list of _pointers_ to lessons under `tasks/lessons/` (including `_archive/`) whose `applies_to` topic tags overlap with the task. Return paths only — never load, read, or paraphrase lesson bodies into context. The agent decides whether to `Read` each pointer.
## Process
The deterministic loop (vocabulary discovery, scoring, supersession resolution, output formatting) lives in `scripts/lesson-resurface.sh`. The skill is a thin pass-through:
```bash
scripts/lesson-resurface.sh "<task summary>"
```
Or, if invoking without a CLI argument, set the env var:
```bash
LESSON_QUERY="<task summary>" scripts/lesson-resurface.sh
```
Read the helper's stdout. It already emits the exact output format described under `## Output Format` below. **Do not** invent a different format — the helper is the source of truth.
## Kit Context
Before running this skill, ensure session boot is done:
1. Read `CODEBASE_MAP.md`
2. Read `CLAUDE.project.md` if it exists
3. Read `tasks/lessons/_index.md` Top Rules section (already injected by `session-start.sh`)
This skill is the **dormant-layer complement** to Top Rules:
- Top Rules = active layer, auto-injected at session start
- Recently Added / By Topic = active discoverable layer in `_index.md`
- `/lesson-resurface` = surfaces lessons outside those layers — archived or superseded — when the current task touches a topic they covered
## When to Use
Invoke with `/lesson-