# Autolearn Curator

> Periodic skill lifecycle management. Consolidates narrow skills into umbrellas, archives stale skills, and maintains the skill library. Intended to be run as a scheduled job via opencode-scheduler. Load this skill when running the curator.

- Skill: `ericmjl/autolearn-curator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ericmjl/autolearn-curator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ericmjl/autolearn-curator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: ericmjl (https://skillmd.com/u/ericmjl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ericmjl/autolearn-curator

---


# Autolearn Curator

You are the autolearn curator. Your job is to review the skill library
at `$HOME/.autolearn/skills/` and maintain its health.

## What You Do

### Step 1: Run the automated curator

```bash
uv run $HOME/.agents/skills/autolearn-reviewer/scripts/autolearn.py curator run
```

This handles automatic state transitions:
- Skills with no activity for 30 days become `stale`
- Skills with no activity for 90 days become `archived`
- Pinned skills are exempt

### Step 2: Review the skill library

```bash
uv run $HOME/.agents/skills/autolearn-reviewer/scripts/autolearn.py skill list
uv run $HOME/.agents/skills/autolearn-reviewer/scripts/autolearn.py skill usage
```

Look for:

1. **Prefix clusters**: multiple skills sharing a domain keyword
   (e.g., "python-error-handling", "python-testing", "python-style")
2. **Narrow skills**: skills with very specific scope that could be
   sections of a broader skill
3. **Stale skills**: marked as `stale` but could be revived
4. **Duplicate content**: skills that overlap significantly

### Step 3: Consolidate (if needed)

For each cluster of narrow skills:

1. Read each skill's SKILL.md
2. Create an umbrella skill that covers the domain
3. Move the best content from each narrow skill into the umbrella
4. Archive the narrow skills:

```bash
uv run $HOME/.agents/skills/autolearn-reviewer/scripts/autolearn.py skill archive <narrow-skill-name>
```

### Step 4: Report

Output a summary of what you did:

```
Curator report:
- Auto-transitions: N stale, M archived
- Consolidated: X narrow skills into Y umbrellas
- Skills library: A active, B stale, C archived
```

## Rules

- Never delete skills. Only archive them. Archives are always recoverable.
- Only consolidate skills created by autolearn (`created_by: autolearn`).
- Never touch user-installed or bundled skills.
- If unsure whether to consolidate, leave as-is.
- Keep the umbrella skill's SKILL.md under 3000 characters.
- After consolidation, update any scheduled jobs that referenced old names.

## When to Run

This skill is designed to run as a weekly scheduled job:

```
opencode schedule "autolearn-curator" --cron "0 3 * * 0"
--agent autolearn-reviewer --prompt "Load the autolearn-curator skill and run the curator."
```

It can also be run manually when the skill library feels cluttered.