learnlisted

# Learn Skill Orchestrates research via the `sme-researcher` agent and persists findings. **Arguments:** `$ARGUMENTS` ## Bounds - **Research time**: ~2-3 minutes maximum - **Sources**: Stop after 6 quality sources found - **Use `max_turns: 5`** on sme-researcher to limit research iterations - If sources found quickly, stop early — don't hunt for more ## Steps ### 1. Parse arguments - Extract `<topic>` and optional flags (`--skill`, `--global`) from arguments. - Normalize topic to **kebab-case** for file naming. - If topic is empty, show usage examples and stop. **Extended invocation: suggest improvements to an existing skill.** The format `/learn <topic> and suggest improvements to the '<skill-name>' skill` is fully supported. After writing the lode draft, read the named SKILL.md and present a diff-style list of improvements drawn from the research findings. Ask "Apply these improvements?" before making any changes. This pattern works for lode output only (not `--skill`). ### 2. Determine output target Check if `lode/` exists (`Glob: lode/lode-map.md`): | Condition | Output target | |-----------|--------------| | `lode/` exists, no `--skill` flag | **lode/** (default) | | `--skill` flag provided | **SKILL.md** (project-local or `--global`) | | No `lode/` and no `--skill` flag | **Prompt user**: create lode/, create as skill, or create as global skill | **If lode/ exists:** Read `lode/lode-map.md` to identify any existing lode files related to the topic. Skim relev