README.md

Skills

Use this repo as your agent skills directory.

Enable the pre-commit hook:

git config core.hooksPath .githooks

Pull the vendored skills, and auto-pull them on future fetches and checkouts:

git submodule update --init --recursive
git config submodule.recurse true

Symlink the skills directory:

mkdir -p ~/.agents
ln -s "$(realpath skills)" ~/.agents/skills
# Claude Code
ln -s "$(realpath skills)" ~/.claude/skills

Global Instructions

Symlink the global instruction files:

# Claude Code
ln -s "$(realpath global/CLAUDE.md)" ~/.claude/CLAUDE.md
ln -s "$(realpath global/claude.settings.json)" ~/.claude/settings.json
# Codex
ln -s "$(realpath global/CODEX.md)" ~/.codex/AGENTS.md
# Pi
ln -s "$(realpath global/PI.md)" ~/.pi/agent/APPEND_SYSTEM.md

Edit global/parts/ — the pre-commit hook rebuilds automatically.

Preferred Tools

The global instructions assume these CLI tools are available:

brew install jq yq

Recommended Pi Extensions

pi install npm:pi-thinking-status
pi install npm:@peron_js/web-pi

Available Skills

• better-skill-creator: write better skills than the default
• linear: manage Linear issues from intake through completion
• rust-coding: write high-quality Rust code

Vendored

Symlinked from vendor/vercel-agent-skills (vercel-labs/agent-skills):

• react-best-practices: React and Next.js performance patterns from Vercel Engineering