# Skill Manager

> Skill Manager

- Skill: `wang499411300/skill-manager` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add wang499411300/skill-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wang499411300/skill-manager/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wang499411300 (https://skillmd.com/u/wang499411300)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/wang499411300/skill-manager

---


# Skill Manager

Manage all installed Codex skills: scan, subscribe, unsubscribe, and output a categorized markdown dictionary for offline browsing.

## When to Use

Invoke when the user asks to:

- "sync skills" / "update skill dictionary"
- "show my skills" / "what skills do I have"
- "subscribe to X" / "unsubscribe X"
- "show new skills only"
- "regenerate skill dictionary"

Do not invoke automatically at session start unless the user asks.

## Output Location

All output lands in `~/Desktop/codex_skill_dir/`:

| File | Purpose |
|------|---------|
| `skill-registry.json` | Persistent registry of all known skills with subscription status |
| `skills-dictionary.md` | Human-readable markdown dictionary, organized by category |

The dictionary separates subscribed (commonly used) skills at the top into categorized sections, and hides unsubscribed skills under a `---` divider and a single "已隐藏 (Unsubscribed)" section at the bottom.

## Workflow

### 1. Sync

```bash
python ~/.codex/skills/skill-manager/scripts/skill-manager.py sync

Scans all skill directories (user skills, `.system` skills, plugin skills, nested skills), compares against the registry, detects new skills, and regenerates `skills-dictionary.md`.

### 2. Subscribe / Unsubscribe

```bash
python ~/.codex/skills/skill-manager/scripts/skill-manager.py subscribe "<skill-name>"
python ~/.codex/skills/skill-manager/scripts/skill-manager.py unsubscribe "<skill-name>"

### 3. View (in terminal)

```bash
python ~/.codex/skills/skill-manager/scripts/skill-manager.py show
python ~/.codex/skills/skill-manager/scripts/skill-manager.py show new
python ~/.codex/skills/skill-manager/scripts/skill-manager.py show subscribed

### 4. Regenerate markdown only (no rescan)

```bash
python ~/.codex/skills/skill-manager/scripts/skill-manager.py markdown

## Status Symbols

| Symbol | Status | Meaning |
|--------|--------|---------|
| 👍 | subscribed | Actively used, appears in main dictionary |
| 🆕 | new | Newly discovered, not yet classified |
| ⛔ | unsubscribed | Hidden from main dictionary, listed in bottom section |
| 🗑️ | removed | Skill directory removed since last scan |

## Automatic New Skill Detection

On every `sync`, the script compares the current filesystem state against the registry. Any skill directory with a `SKILL.md` file that is not in the registry is marked as `new` and shown with a 🆕 badge. The user can then subscribe to keep it visible or ignore it (it will stay as `new` until subscribed or explicitly unsubscribed).