pr-skills

Built by Docfork

Curated pull request skills for AI coding agents (OpenCode, Claude Code, Codex, Cursor).

Each skill is a small, reviewable workflow in skills/<skill-name>/SKILL.md (with name + description frontmatter).

Installation

npm install -g pr-skills

Quick Start

# see what's bundled in this package
pr-skills list

# install all bundled pr skills (global)
pr-skills add --all --global --yes

Usage

Commands

| Command | Purpose | | ------------------------------------- | ------------------------------------------------ | | pr-skills list | list bundled skills | | pr-skills add | install selected skills (interactive by default) | | pr-skills add --all | install all bundled skills | | pr-skills rm / pr-skills remove | uninstall selected skills |

Options

| Option | Description | | ------------------------- | ---------------------------------------------------------- | | -g, --global | install to user directories instead of the current project | | --agent <agents...> | target specific agents (e.g. cursor, claude-code) | | -s, --skill <skills...> | select skills by name (skip selection prompt) | | --mode <mode> | install mode: copy (default) or symlink | | -y, --yes | skip confirmation prompts |

Examples

# list skills
pr-skills list

# install one skill globally to cursor + claude-code
pr-skills add -g --agent cursor claude-code --skill <skill-name>

# install everything globally (ci-friendly)
pr-skills add --all -g -y

# remove one skill globally
pr-skills rm -g --skill <skill-name> -y

Supported Agents

This CLI can install skills into these agent directories:

| Agent | --agent | Project Path | Global Path | | ----------- | ------------- | ------------------- | ---------------------------- | | Cursor | cursor | .cursor/skills/ | ~/.cursor/skills/ | | Claude Code | claude-code | .claude/skills/ | ~/.claude/skills/ | | Codex | codex | .codex/skills/ | ~/.codex/skills/ | | OpenCode | opencode | .opencode/skills/ | ~/.config/opencode/skills/ |

How installs work

• source of truth: bundled skills live under ./skills/<skill-name>/SKILL.md
• canonical store: installs copy into .agents/skills/<skill-name>/ (project) or ~/.agents/skills/<skill-name>/ (global)
• agent install:
  • copy: copies from canonical store into each agent directory
  • symlink: symlinks each agent directory to canonical store

Available Skills

This section is auto-generated from ./skills/*/SKILL.md. To refresh it, run npm run sync-skills.

Contributing

This repo is curated. Skill requests and focused PRs are welcome.

• request a skill: open an issue using the “pr-skills request” template
• contribute a skill: see CONTRIBUTING.md

Troubleshooting

"No skills found"

• ensure skills live at skills/<skill-name>/SKILL.md
• ensure frontmatter has name and description
• ensure name matches the directory name exactly

Skill not loading in agent

• verify the skill exists under the agent skills directory after install
• some agents require additional configuration to load skills from disk

License

MIT