skills · INSTALL.html
Agent skills · install walkthrough
/skills

Agent skills that follow the open Agent Skills spec — usable by Claude Code, Codex, and any compliant agent. Installed straight from GitHub, no npm. Pick a path below.

Agent Skills spec GitHub-hosted Codex & Claude No npm No third-party installer
00 / what you're installing

A skill is just a folder

Every skill in this repo is a self-contained folder under skills/ with a SKILL.md inside, plus any references/ or assets/ it needs. Your agent reads that folder and gains the workflow.

Because a skill is only files, there's nothing to compile and nothing to run from a registry. The two automated paths below just move these folders into the place your agent already looks — and you can always do it by hand.

Skills are read from ~/.codex/skills/ (Codex CLI) or ~/.claude/skills/ (Claude Code). A shared ~/.agents/skills/ store can be symlinked into either, so one copy serves both. Claude Code can also consume this repo as a plugin — that's path A.
Every skill here conforms to the open Agent Skills specification and is validated in CI with skills-ref. That's the standard the copy-into-any-agent promise rests on — any compliant agent reads the same folder.
01 / which path is yours

Pick your path

Path A

Claude Code

Native /plugin marketplace install. Auto-updates from GitHub.

Claude Code ↓
Path B

Codex / spec-compatible agent

Clone the repo and run install.sh to copy skills in.

git + install.sh ↓
Path C

By hand

No script — copy a single skill folder yourself.

Manual copy ↓

Every path is pure GitHub + git. None of them download or execute an npm package.

02 / before you start

Short list

ForYou need
Path AClaude Code installed and signed in. That's it — it fetches the repo itself.
Path B / Cgit, plus a Bash-capable shell. macOS and Linux ship one; on Windows use Git Bash or WSL.
Path A / Claude Code marketplace

Native, auto-updating, Claude only

1

Register the marketplace

Run this inside Claude Code. It clones the repo from GitHub and reads its plugin catalog — no npm, no registry.

in Claude Code
/plugin marketplace add brandtam/skills
2

Install the plugin

The repo ships as a single plugin named brandtam-skills in a marketplace named brandtam. Installing it brings in every skill at once.

in Claude Code
/plugin install brandtam-skills@brandtam
3

Confirm

Open the plugin menu to see it listed and enabled. The skills are now available to Claude by name, or via each skill's slash command.

in Claude Code
/plugin
Updating later: re-run /plugin marketplace add brandtam/skills to refresh the catalog; Claude Code pulls the latest from GitHub. To remove it, open the /plugin menu and uninstall brandtam-skills.
Path B / git clone + install.sh

Cross-tool — works for Codex and for Claude

1

Clone the repo

A normal git clone. The skills sit right there in skills/ for you to inspect before anything is installed.

terminal
git clone https://github.com/brandtam/skills.git
cd skills
2

Run the installer

install.sh copies skill folders into ~/.agents/skills/. It's plain Bash — it only reads the folders next to it and copies them. Nothing is fetched or executed from the network.

install everything
./install.sh
or just the ones you want
./install.sh write-commit prepare-release
target a specific agent's folder
DEST=~/.codex/skills  ./install.sh    # Codex CLI
DEST=~/.claude/skills ./install.sh    # Claude Code
3

Reload your agent

Restart Codex or Claude, or reload skills, so it re-scans the skills directory. The new skills are now available.

Updating later: git pull inside the cloned folder, then run ./install.sh again. It replaces each skill folder cleanly.
Path C / by hand

No script — just a copy

If you'd rather not run a script at all, copy any single skill folder into your agent's skills directory. This is the most transparent option — you can read every file first.

terminal
# from inside the cloned repo, pick whichever skill you want
cp -R skills/write-commit ~/.codex/skills/

Destination depends on your agent: ~/.codex/skills/ for Codex CLI, ~/.claude/skills/ for Claude Code, or a shared ~/.agents/skills/ store symlinked into either. To remove a skill, delete its folder.

03 / verify it took

Trust, then check

PathHow to confirm
A/plugin in Claude Code lists brandtam-skills as enabled.
B / Cls the folder you installed into, e.g. ~/.codex/skills, shows each skill with its SKILL.md.
terminal — list installed skills
ls -1 ~/.codex/skills
04 / what's in the box

The skills

SkillWhat it does
prepare-releaseCut a release from pending changesets — version preview, changelog, archived notes, tag / GitHub Release steps.
write-changesetWrite or update a changeset for a PR or branch, scaffolding the workflow if it's missing.
write-commitGenerate structured commit messages and optionally commit — honors templates, requires your approval before committing.
uatRun a user-acceptance-testing session: collect observations, grill for decisions, then generate a PRD.
resurrect-projectRevive a dormant project — survey the code as historical signal, interview on today's intent, scaffold a rewrite plan.
05 / repo layout

So you know what you're cloning

.claude-plugin/ marketplace.json # catalog — lists this repo as one plugin (path A) plugin.json # this repo IS the plugin; skills auto-discovered skills/ prepare-release/ SKILL.md references/ write-changeset/ SKILL.md references/ assets/ write-commit/ SKILL.md uat/ SKILL.md resurrect-project/ SKILL.md flows/ references/ templates/ install.sh # copies skills/* into a skills dir (path B, bash, no npm) validate.sh # checks skills against the Agent Skills spec (python, no npm) .github/workflows/ # CI: runs spec validation on every push / PR README.md LICENSE INSTALL.html
brandtam/skills · MIT · standalone — no npm, no third-party installer · styled with the bli design system · replace brandtam/skills with your own owner/repo if you forked it