← ClaudeAtlas

lesson-resurfacelisted

Surface archived or superseded lessons whose topic tags match the current task — returns pointers (paths only), never bodies. Use when a task touches an area past sessions may have covered, to recover dormant context without bloating boot.
tansuasici/claude-code-kit · ★ 1 · AI & Automation · score 77
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-