agent-skills

Custom AI coding agent skills for automated development workflows. Agent-agnostic — works with Claude Code, Codex, or any agent that supports markdown-based skills.

Skills

Skill	Description
pr-review-loop	Automated PR review-fix-verify cycle for superpowers + pr-review-toolkit. Chains review, evaluation, implementation, verification, and re-review into a loop that runs until clean.
reviewing-plans	Two-stage review gate for the superpowers design→plan→execution workflow. Reviews designs before planning, then reviews plans against designs before execution.
iterative-plan-review-loop	Manual-invocation skill for repeated fresh-subagent plan review loops (review -> patch -> re-review) until NO_FINDINGS or iteration cap.
iterative-code-review-loop	Manual-invocation skill for repeated post-implementation review hardening loops (request-review -> receive-review -> commit) until no Critical/Important findings or iteration cap.
commit	Focused commit skill for intent-based staging, conventional commit messages, and safe per-commit verification.
create-pr	PR authoring skill for purpose-first titles/bodies, scoped change summaries, and verification evidence.
merge-main-safely	Conservative branch sync skill for merging latest upstream base branch with conflict-aware validation.

Installation

Preferred: install from this repo with the helper script:

./install.sh

Or via Make:

make install-skills

This script:

• detects installed agents via command -v
• symlinks all SKILL.md folders with ln -sfn
• links Claude Code skills to ~/.claude/skills
• links Codex skills to ~/.agents/skills

To remove only symlinks created from this repo:

./uninstall.sh

Or via Make:

make uninstall-skills

Manual symlink setup (if you prefer):

# Claude Code — single skill
mkdir -p ~/.claude/skills
ln -sfn /path/to/agent-skills/pr-review-loop ~/.claude/skills/pr-review-loop

# Claude Code — all skills
for skill in /path/to/agent-skills/*/; do
  name=$(basename "$skill")
  [ -f "$skill/SKILL.md" ] || continue
  mkdir -p ~/.claude/skills
  ln -sfn "$skill" ~/.claude/skills/"$name"
done

# Codex — all compatible skills
for skill in /path/to/agent-skills/*/; do
  name=$(basename "$skill")
  [ -f "$skill/SKILL.md" ] || continue
  mkdir -p ~/.agents/skills
  ln -sfn "$skill" ~/.agents/skills/"$name"
done

Note: Not all skills are compatible with all agents. Check each skill's README for compatibility. Codex note: ~/.agents/skills is the current path. ~/.codex/skills may still work as legacy compatibility in some setups.

Skills are available immediately in all sessions after symlinking.

Prerequisites

Skills in this repo may depend on:

• superpowers — core skills library (TDD, debugging, code review, etc.)
• pr-review-toolkit — specialized PR review agents

Check each skill's SKILL.md and README for specific requirements.

Adding a New Skill

mkdir skill-name
# Add SKILL.md (required) and README.md (recommended)
# Update the table in this README

License

MIT