skill CX Codex

gsd-2-agent-framework — Claude Code skill

Q: How do I install gsd-2-agent-framework in Claude Code?

Run `npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a claude-code`. The skill lands at `~/.claude/skills/gsd-2-agent-framework/SKILL.md`.

Q: What is needed to run GSD 2?

Node.js 18+ and the `gsd-pi` package installed globally (`npm install -g gsd-pi`). It uses Claude as the model via the Pi SDK, so Anthropic access is required.

A skill that documents the GSD 2 CLI, which walks a spec through milestone, slice and task levels and writes the code unattended. Handy when you want a long job to run while you are away.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a claude-code

Open on GitHub

What gsd-2-agent-framework does

GSD 2 is a separate command-line tool: feed it a structured spec and it produces a working project. The skill covers how its loop is wired. Every task gets its own fresh context window instead of one endless conversation where edits start contradicting each other. Position lives in .gsd/STATE.md, architecture choices accumulate in .gsd/DECISIONS.md, and token spend is tracked per unit in .gsd/costs/ledger.json.

The hierarchy is strict. A milestone is a shippable version, a slice is one demonstrable vertical capability, and a task is a chunk of work that fits one context window. If it does not fit, you split it. That is why a crash does not wipe the whole run: a lock file in .gsd/LOCK drives recovery. Git is handled for you — a branch per milestone, a commit per task, then a single squash merge into main.

Before any of this runs you need Node.js 18+ and the gsd-pi package installed globally; the underlying model is Claude through the Pi SDK, so Anthropic access is required. Done means the must-haves pass: shell commands and file checks written into the task plan. Set --budget on auto runs, otherwise spending keeps going past the point you had in mind.

What it helps with

split a large feature into context-sized tasks
take an API from spec to working code without watching the terminal
resume an agent run after the process dies
cap token spending at a chosen budget
keep git history readable with one commit per task

Example prompts for the agent

Build the .gsd/ directory from my ROADMAP.md and PROJECT.md, then run /gsd init
Start /gsd auto --milestone M1 --budget 5.00 and pause if the spend crosses the limit
Tell me which slice we are on and what it has cost so far with /gsd status

How to install gsd-2-agent-framework

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a claude-code

2Manually: put the files in place

~/.claude/skills/gsd-2-agent-framework/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gsd-2-agent-framework/

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a codex

2Manually: put the files in place

.agents/skills/gsd-2-agent-framework/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a cursor

2Manually: put the files in place

.cursor/skills/gsd-2-agent-framework/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install reason-machines/trending-skills gsd-2-agent-framework

2Manually: put the files in place

.github/skills/gsd-2-agent-framework/SKILL.md

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a gemini-cli

2Platform CLI

gemini skills install https://github.com/reason-machines/trending-skills --path skills/gsd-2-agent-framework

Manually: put the files in place

.devin/skills/gsd-2-agent-framework/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about gsd-2-agent-framework

How do I install gsd-2-agent-framework in Claude Code?

Run npx skills add reason-machines/trending-skills --skill gsd-2-agent-framework -a claude-code. The skill lands at ~/.claude/skills/gsd-2-agent-framework/SKILL.md.

What does gsd-2-agent-framework do?

It documents the GSD 2 autonomous loop: research, plan, execute, verify against must-haves, then move to the next slice. State and costs sit in the .gsd/ directory.

What is needed to run GSD 2?

Node.js 18+ and the gsd-pi package installed globally (npm install -g gsd-pi). It uses Claude as the model via the Pi SDK, so Anthropic access is required.

setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set139

autoresearchclaw-autonomous-research A skill that wires up AutoResearchClaw, a 23-stage pipeline turning one topic string into a paper with verified citations and experiment code. CX Codex +1 1,600installs deepseek-ocr Teaches your coding agent to run DeepSeek-OCR for document parsing and markdown extraction. Works with images and PDFs via vLLM or Transformers. CX Codex +1 1,600installs paperclip-ai-orchestration Teaches coding assistants to manage Paperclip, an open-source platform that runs autonomous AI agents with org charts, task tickets, and budget caps. CX Codex +1 1,500installs marketingskills-ai-agents Connect an AI coding agent to marketing skills for SEO, copy, analytics, and conversion work. Start by giving the agent shared context about your product. CX Codex +1 1,500installs opencli-web-automation Turns target websites into console utilities by tapping into live Chrome sessions. Useful when you need scraped data from authenticated portals without writing raw scripts. CX Codex +1 1,500installs chrome-cdp-live-browser Hooks an AI agent into the Chrome you already have running, over the DevTools Protocol. Your tabs, logins and page state stay as they are. CX Codex +1 1,500installs lightpanda-browser A skill that teaches your agent to run Lightpanda: install the Zig headless browser, start a CDP server, and hook Playwright or Puppeteer to it. CX Codex +1 1,500installs vinext-vite-nextjs Guides your AI assistant through running Next.js codebases on Vite and deploying them to Cloudflare Workers. CX Codex +1 1,400installs