Portable agent skills and matching review subagents for Claude Code, OpenCode, and Codex.
skills/review-work/SKILL.md: multi-specialist code review skillskills/goodreview/SKILL.md: portable multi-specialist code review using generic subagentsskills/goodreview-pr-reply/SKILL.md: post a goodreview report to a pull request as an overview comment and inline review commentsskills/scratchpad/SKILL.md: gitignored temporary project scratchpad workflowskills/git/SKILL.md: git commit and pull request workflow commandsskills/inspector/SKILL.md: OpenSpec inspection and reconciliation workflowsskills/inspector-review-update/SKILL.md: OpenSpec quick review + auto-patch (--askor--autofor design questions)skills/implement-openspec-changes/SKILL.md: apply, verify, review, and commit OpenSpec changes via subagentsskills/openspec-ship/SKILL.md: rebase, apply, verify, review, archive, commit, and open one draft PR for OpenSpec changesskills/openspec-to-tickets/SKILL.md: break OpenSpec changes into tracer-bullet tickets on GitHub, Linear, Jira, or local markdownskills/openspec-ship-tickets/SKILL.md: ship openspec-to-tickets tickets one pipeline per ticket, serially or in parallel child threads/orbs, then one draft PRskills/document/SKILL.md: focused documentation generation (inline, API, guide, external)skills/understand/SKILL.md: multi-specialist codebase understanding analysisskills/elixir-genius/SKILL.md: Elixir/Phoenix/LiveView architecture and best practices
skills/check/SKILL.md: run project quality checks viajust checkwith auto-fix subcommandskills/credo/SKILL.md: run Credo static analysis with check and fix subcommandsskills/justfile/SKILL.md: generate a justfile for the current projectskills/publish/SKILL.md: publish a release viajust publishskills/workie/SKILL.md: git worktree lifecycle manager with branch-isolated databases
skills/boruta/SKILL.md: add OAuth 2.0 and OpenID Connect provider using Borutaskills/can-opener/SKILL.md: create and update Elixir API client packages using CanOpenerskills/durex/SKILL.md: add GenServer state checkpointing (Redis or Tigris) for crash recoveryskills/horde/SKILL.md: set up Horde distributed process infrastructure (registry, supervisor, cluster monitor)skills/openapi/SKILL.md: regenerate OpenAPI specs in Phoenix apps using open_api_spexskills/pgflow/SKILL.md: PgFlow PostgreSQL-based workflow engine for Elixir/Phoenixskills/tango/SKILL.md: add per-tenant OAuth connections to third-party APIs using Tango
skills/goodverify/SKILL.md: verify emails, phones, and addresses via the GoodVerify CLIskills/goodissues/SKILL.md: manage projects and track issues via the GoodIssues CLIskills/goodissues-reporter/SKILL.md: set up GoodIssuesReporter error tracking and monitoring in Phoenixskills/searchapi/SKILL.md: SearchAPI.io CLI (Google Jobs, Events, News, Maps, Zillow, Locations)skills/listex/SKILL.md: Listex/Yocal city platform CLI (content, city-scoped pages, email broadcasts)skills/zig-cli/SKILL.md: build and maintain Zig CLI applications with cross-compilation and OpenAPI client generation
skills/bootstrap-phoenix/SKILL.md: Phoenix applicationskills/bootstrap-astro/SKILL.md: Astro siteskills/bootstrap-astro-ses/SKILL.md: Astro site with AWS SES form handlingskills/bootstrap-accounts/SKILL.md: multi-tenant account-scoped dashboardskills/bootstrap-api-keys/SKILL.md: API key management UI and backendskills/bootstrap-client-ip/SKILL.md: client IP extraction from proxy headersskills/bootstrap-credits/SKILL.md: credit system with Stripe integrationskills/bootstrap-elixir-openapi/SKILL.md: Elixir API client from OpenAPI specskills/bootstrap-env-banner/SKILL.md: non-production environment warning bannerskills/bootstrap-events/SKILL.md: event subscription systemskills/bootstrap-fly-env-sync/SKILL.md: sync env vars to Fly.io secretsskills/bootstrap-go-cli/SKILL.md: Go CLI with Cobra, Viper, and goreleaserskills/bootstrap-go-openapi/SKILL.md: Go client from OpenAPI specskills/bootstrap-google-analytics/SKILL.md: Google Analytics (GA4) in Phoenixskills/bootstrap-mcp/SKILL.md: MCP server for Phoenixskills/bootstrap-mcp-oauth/SKILL.md: OAuth 2.1 + PKCE for a Phoenix MCP serverskills/bootstrap-nebulex/SKILL.md: Nebulex caching in Phoenixskills/bootstrap-openapi/SKILL.md: OpenAPI for Phoenixskills/bootstrap-phoenix-docker/SKILL.md: Docker releases for Phoenixskills/bootstrap-posthog/SKILL.md: PostHog analytics in Phoenixskills/bootstrap-postmark/SKILL.md: Postmark mailer in Phoenixskills/bootstrap-registration-toggle/SKILL.md: ENV-based registration toggleskills/bootstrap-user-management/SKILL.md: account member management UI and backendskills/bootstrap-zig-cli/SKILL.md: Zig CLI application (standalone bootstrap)
agents/claude/: Claude Code custom agentsagents/opencode/: OpenCode markdown subagentsagents/codex/: Codex custom agent TOML files
The review-work skill expects these specialist names across runtimes:
code-review-expertsecurity-engineerqa-cli-expertquality-engineerelixir-expertreact-expertui-engineering-expertpostgres-experttechnical-writersystem-architect
Additional utility agents (available across all three runtimes):
astrojs-expert— Astro websites, content collections, island architecturecode-reviewer— General code review with checklist and commit readinessdata-analyst— SQL queries, business intelligence, data patternselixir-qa— Runs mix precommit with concise issue summariesrefactoring-expert— Code simplification, technical debt, SOLID patternsrequirements-analyst— Requirements discovery, PRDs, user storiesroot-cause-analyst— Systematic debugging and evidence-based investigationtailwind-expert— Tailwind CSS styling, responsive design, theme configuration
This repository is compatible with the Vercel Labs skills CLI.
List available skills:
npx skills add agoodway/skills --listInstall the primary skills into the current project for Claude Code, OpenCode, and Codex:
npx skills add agoodway/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -a claude-code -a opencode -a codexInstall globally instead:
npx skills add agoodway/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -g -a claude-code -a opencode -a codex -yInstall from a local checkout:
npx skills add /path/to/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -a claude-code -a opencode -a codexInstall all skills from this repository:
npx skills add agoodway/skills --skill '*' -a claude-code -a opencode -a codexUse --copy if you want copied files instead of symlinks:
npx skills add agoodway/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -a claude-code -a opencode -a codex --copyThe skills CLI installs skills, not custom subagents.
Project installs use these runtime paths:
| Runtime | Project Skill Path | Global Skill Path |
|---|---|---|
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| OpenCode | .agents/skills/ |
~/.config/opencode/skills/ |
| Codex | .agents/skills/ |
~/.codex/skills/ |
Install the matching subagents separately after installing the skill. The skills CLI installs SKILL.md files only; it does not install the custom agent files in agents/.
If you do not already have this repository checked out locally, fetch a temporary copy first:
tmpdir=$(mktemp -d)
git clone https://github.com/agoodway/skills.git "$tmpdir/skills"The commands below use $tmpdir/skills as the source path.
Global install:
mkdir -p ~/.claude/agents
cp "$tmpdir/skills"/agents/claude/*.md ~/.claude/agents/Project install:
mkdir -p .claude/agents
cp "$tmpdir/skills"/agents/claude/*.md .claude/agents/OpenCode loads markdown agents from ~/.config/opencode/agents/ globally or .opencode/agents/ per project.
Global install:
mkdir -p ~/.config/opencode/agents
cp "$tmpdir/skills"/agents/opencode/*.md ~/.config/opencode/agents/Project install:
mkdir -p .opencode/agents
cp "$tmpdir/skills"/agents/opencode/*.md .opencode/agents/Codex loads custom agents from ~/.codex/agents/ globally or .codex/agents/ per project.
Global install:
mkdir -p ~/.codex/agents
cp "$tmpdir/skills"/agents/codex/*.toml ~/.codex/agents/Project install:
mkdir -p .codex/agents
cp "$tmpdir/skills"/agents/codex/*.toml .codex/agents/Optional project Codex concurrency config:
mkdir -p .codex
cat > .codex/config.toml <<'EOF'
[agents]
max_threads = 6
max_depth = 1
EOFInstall the skill globally and install all three agent sets globally from a temporary repository checkout:
npx skills add agoodway/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -g -a claude-code -a opencode -a codex -y
tmpdir=$(mktemp -d)
git clone https://github.com/agoodway/skills.git "$tmpdir/skills"
mkdir -p ~/.claude/agents ~/.config/opencode/agents ~/.codex/agents
cp "$tmpdir/skills"/agents/claude/*.md ~/.claude/agents/
cp "$tmpdir/skills"/agents/opencode/*.md ~/.config/opencode/agents/
cp "$tmpdir/skills"/agents/codex/*.toml ~/.codex/agents/For a single project, run this from that project root:
npx skills add agoodway/skills --skill review-work --skill goodreview --skill scratchpad --skill git --skill inspector --skill inspector-review-update --skill document --skill understand --skill elixir-genius -a claude-code -a opencode -a codex
tmpdir=$(mktemp -d)
git clone https://github.com/agoodway/skills.git "$tmpdir/skills"
mkdir -p .claude/agents .opencode/agents .codex/agents
cp "$tmpdir/skills"/agents/claude/*.md .claude/agents/
cp "$tmpdir/skills"/agents/opencode/*.md .opencode/agents/
cp "$tmpdir/skills"/agents/codex/*.toml .codex/agents/If you already have a local checkout, replace "$tmpdir/skills" with that path.
List installed skills:
npx skills listCheck that agent files exist:
ls ~/.claude/agents
ls ~/.config/opencode/agents
ls ~/.codex/agentsFor project installs:
ls .claude/agents
ls .opencode/agents
ls .codex/agentsAsk your runtime to run the skill:
/review-work
/goodreview
/scratchpad bootstrap
/git help
/inspector help
/inspector-review-update [change-id] --ask
/inspector-review-update [change-id] --auto
/implement-openspec-changes [change-id ...]
/openspec-ship [change-id ...]
/document lib/my_app/accounts.ex inline
/understand authentication system
/elixir-genius
Or focus the review on a path or area, or give goodreview a base ref to review committed work:
/review-work lib/my_app/accounts
/review-work frontend settings modal
/review-work docs setup guide
/goodreview lib/my_app/accounts
/goodreview frontend settings modal
/goodreview main
The skill gathers git context, selects specialists based on changed files, launches matching agents where supported, runs a Codex fresh-eyes/meta-analysis pass when available, and returns a prioritized review report.
/goodreview is the portable engine: it selects roles by what the change puts at risk, launches generic subagents with skill-owned briefs, has a second model try to refute each finding, and prints a verdict-first report of what survived. It does not require named custom agents. Pass a base ref (/goodreview main) to review committed work. Fresh Eyes and verification run on a model other than the host: Claude hosts use Codex MCP or the Grok CLI, Codex hosts use the Grok or Claude CLI, and Grok hosts use Codex MCP or the Claude CLI. If no external provider is usable, the skill falls back to a generic or separately labeled host pass.
After a review, /goodreview-pr-reply [selection prompt] posts the report to the branch's pull request as one review: an overview comment plus an inline comment per finding. The prompt picks which findings to post (/goodreview-pr-reply blockers only); the skill shows the draft and waits for approval before posting.
- The
skillsCLI can installSKILL.mdfiles for many runtimes, but it does not install custom agent definitions fromagents/. - Keep agent filenames aligned across
agents/claude/,agents/opencode/, andagents/codex/soreview-workcan use the same specialist names everywhere. - Codex custom agent filenames can differ from their
namefields, but this repository keeps them matching for clarity.