red-skills

   ██████╗ ███████╗██████╗     ███████╗██╗  ██╗██╗██╗     ██╗     ███████╗
   ██╔══██╗██╔════╝██╔══██╗    ██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝
   ██████╔╝█████╗  ██║  ██║    ███████╗█████╔╝ ██║██║     ██║     ███████╗
   ██╔══██╗██╔══╝  ██║  ██║    ╚════██║██╔═██╗ ██║██║     ██║     ╚════██║
   ██║  ██║███████╗██████╔╝    ███████║██║  ██╗██║███████╗███████╗███████║
   ╚═╝  ╚═╝╚══════╝╚═════╝     ╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝

   /start   ─▶   /to-prd   ─▶   /to-issues   ─▶   /triage   ─▶   ⚡ /afk
   refine        publish        slice into        write the      drain →
   the plan      a PRD          vertical          AGENT-BRIEF    test, merge,
                                slices                           close, repeat

A reddb.io adaptation of mattpocock/skills — same DNA, sharper edges, an autonomous loop layered on top. Massive thanks to @mattpocock; the original lives at aihero.dev. We pin upstream via .upstream and a daily workflow (red-upstream-watch.yml) opens an issue when it advances, so we cherry-pick what's worth taking.

Install

The fastest path — and the only one that auto-updates. RedSkills ships as a Claude Code plugin marketplace: add the marketplace once, install the plugin, and Claude Code pulls new commits at startup automatically.

1. Marketplace (recommended — auto-updates)

Inside Claude Code:

/plugin marketplace add reddb-io/red-skills
/plugin install red-skills@red-skills

That's it. From now on Claude Code checks reddb-io/red-skills at every session start and pulls new skills/fixes silently. Toggle the behaviour with /plugin → Marketplaces → select red-skills → Enable auto-update (default on for this marketplace).

To force a refresh without restarting:

/plugin marketplace update red-skills

To remove:

/plugin uninstall red-skills@red-skills
/plugin marketplace remove red-skills

2. npx skills (alternative — Matt's installer)

npx skills@latest add reddb-io/red-skills

skills.sh walks you through which skills to install and which coding agents to install them on. No auto-update — re-run the command to pull new versions. Same installer Matt uses for his upstream repo — credit to @mattpocock.

3. Manual clone + symlinks (hack-friendly)

For local edits or $<name> access from Codex / Gemini CLI:

git clone [email protected]:reddb-io/red-skills.git ~/code/red-skills
cd ~/code/red-skills
./scripts/link-skills.sh         # symlinks every SKILL.md into ~/.claude/skills/

Update later with git pull && ./scripts/link-skills.sh. Symlinks point at the working tree, so a git pull updates every agent at once.

Pick your agent

Teach Codex (or any non-Claude-Code agent) the convention by appending to ~/.codex/AGENTS.md:

## RedSkills

When the user types `$<name>` (e.g. `$afk`, `$wiki`, `$triage`), look up
`~/.claude/skills/<name>/SKILL.md` and follow it — usually that means running
`bash ~/.claude/skills/<name>/scripts/<entrypoint>.sh` with the documented flags.
Each SKILL.md is self-documenting; read it before invoking.

Bootstrap a repo

Run once per target repo (from inside the repo):

/setup-red-skills

It walks you through five short decisions: