🇰🇷 한국어: README.ko.md
agent-skill

Agent-first workflows that run themselves. One /agent-init per project; one /agent-all "..." per feature; the agent brainstorms → plans → writes → tests → opens the PR — and keeps iterating until the tests pass — without you babysitting every turn.
Works on Claude Code today, with cross-platform ports for Cursor, GitHub Copilot CLI, VS Code Copilot, Codex CLI, and Gemini CLI. 17 plugins, 5 slash commands, one marketplace.
/agent-init # bootstrap any git repo (Phase A — once per project)
/agent-all "Add Google OAuth" --loop # brainstorm → plan → code → test → PR (Phase C — per feature)
/visual-qa # screenshot every page, LLM design review
/thrift # keep long sessions affordable (auto-summarize, audit)
/explore # codebase map; /explore where Foo → O(1) lookup
/debug "tests flaky 30% of runs" # reproduce → bisect → hypothesize → verify
Three things that make it click:
-
Project-first scaffolding. /agent-init works on any git repo — Next.js, FastAPI, Rust CLI, monorepo. It detects your stack, picks the right test command, and creates CLAUDE.md + agents + hooks + config in one commit. Same command, every project.
-
Agent-first execution that preserves your main thread. /agent-all "..." isn't a chat. It runs brainstorm → plan → implement → review → PR as one pipeline, and the implementation/review heavy lifting happens in isolated subagents — their turn-by-turn output never enters your main conversation. A built-in two-layer safety net mandates superpowers:verification-before-completion per implementer + cross-checks at Phase 4 review, so broken code can't sneak into a PR. Your main session stays small (planning + judgment) so the same Claude Code session can keep going for hours without context bloat.
-
Composable for unattended runs. Three pieces — /agent-all --loop (drives the work), /thrift (compresses what does accumulate in main), /goal (keeps the session alive across iterations) — combine into overnight runs that exit cleanly when CI is green or your cost cap hits. See Self-sustaining workflows.
That's it. The rest of this README is reference material — skim the parts you need.
Prerequisites
- Node.js ≥ 20 — required for all install renderers (
bin/init.mjs, bin/install.mjs, scripts/install-all.sh, scripts/install-platform.sh)
- git — required by
/agent-init, /agent-all, and /explore (HEAD-keyed cache)
- gh CLI (optional) — for
/agent-all Phase 5 PR creation; without it, /agent-all falls back to --no-pr mode
- For Claude Code: marketplace plugin support (any recent build)
- For per-platform install: target CLI installed (Cursor, gh copilot, codex, gemini) AND its config dir writable
Strongly recommended (the harness composes on top of these — degrades gracefully if missing):
superpowers@claude-plugins-official — foundational skills (brainstorming, writing-plans, subagent-driven-development, verification-before-completion, etc.)
context-mode@context-mode — keeps raw tool output out of main conversation
See How this fits with the rest of the Claude ecosystem for details on how they integrate.
Install in 60 seconds
First, register the marketplace (once per machine):
/plugin marketplace add https://github.com/kim-song-jun/agent-skill
Option A: one-liner (recommended)
# Outside Claude Code, in a terminal:
git clone https://github.com/kim-song-jun/agent-skill /tmp/agent-skill
bash /tmp/agent-skill/scripts/install-all.sh
Installs all 5 Claude Code essentials at once via the claude CLI. Run --all for all 17 plugins (CLI-platform siblings too), or --cli=codex|copilot|gemini|cursor for a single platform set.
Option B: paste into Claude Code
/plugin install harness-builder@agent-skill
/plugin install harness-floor@agent-skill
/plugin install harness-thrift@agent-skill
/plugin install harness-explore@agent-skill
/plugin install harness-debug@agent-skill
/reload-plugins
(Claude Code's /plugin install accepts only one plugin at a time, so the script in Option A is faster.)
Then in your project
cd my-project
/agent-init
You're done. Try /agent-all "small feature" to see it work.
Keep plugins up to date
/plugin update --marketplace agent-skill