spacezephyr/skilldeck

Turn a bunch of local skills (automatically scanning Codex and Claude Code, possibly hundreds of them) into a card wall: search, filter by category, pick one and click ‘Use’, copy passwords and paste them into Codex to run. You can also package related skills into experts (such as ‘Content Creation Expert’ or ‘Image Design Expert’), allowing Codex to automatically select your keywords throughout the conversation. Supports dark / light skins.

“deck” is a pun: a skill deck + control deck.

---

First Time Using (Standalone Web Version, Recommended to Start with This One)

Zero dependency, only requires Node ≥ 18.

1. Activate

2. Where does Skill come from? (Automatic scanning, no manual path filled)

When starting, SkillDeck will automatically scan the two default locations on the machine, listing whatever you reach in the left sidebar:

The number on the right side of each source shows the number of skills scanned. If the directory does not exist, it is marked as Uninstalled and grayed out. If the directory exists but there is no SKILL.md, it displays 0. Clicking it leads to a blank page, where a “Manual Directory Selection” button is given directly.

If you want to add another directory, click the bottom left Add Local Directory (macOS native selection box), select it and add it to the list automatically and cut through. When creating a custom directory hover, there’s a × on the right side that can be removed from the list (just removing it from the list, keeping the local files intact). Two built-in sources cannot be deleted.

The interface has two levels:

When switching sources, skills and experts are swapped together. Experts are separated by directory; experts built under Codex are not linked into Claude Code. The refresh button at the top right of the top bar allows you to re-scan (click after installing a new skill).

SkillDeck reads the SKILL.md in each subfolder, parses names/descriptions, and automatically categorizes them into cards.

3. Using a skill

Click “Use” on any card→ Enter the specific task (can be left blank), → select password type→ Click “Copy password”→ paste it into the Codex dialog box to send.

• Path password (default, recommended): 请调用 Skill：X ＋ 补充说明 ＋ SKILL.md 调用地址. The password is short; Codex reads the manual by address and does not depend on whether this skill is installed.
• Full password: Inject the entire SKILL.md into the password. Use it when switching machines / Codex cannot read that path.
• Local Running: Do not duplicate, let the SkillDeck backend call the local codex / qodercli to run, resulting in a backlog in the right drawer.

4. Package into experts

Switching to the top bar “expert”: