claude-skills / gstack
AGENTS.md1 starsChanged 3 months agoMITView on GitHub
gstack is a collection of SKILL.md files that give AI agents structured roles for software development. Each skill is a specialist: CEO reviewer, eng manager, designer, QA lead, release engineer, debugger, and more. Skills live in .agents/skills/ (or ~/.claude/skills/gstack/ on Claude Code). Invoke them by name (e.g., /office-hours).
- Deletes or force-pushes
We split this AGENTS.md into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 131
Run bun run gen:skill-docs --host codex to regenerate Codex-specific output.
≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
gstack — AI Engineering Workflow
gstack is a collection of SKILL.md files that give AI agents structured roles for software development. Each skill is a specialist: CEO reviewer, eng manager, designer, QA lead, release engineer, debugger, and more.
Available skills
Skills live in .agents/skills/ (or ~/.claude/skills/gstack/ on Claude Code).
Invoke them by name (e.g., /office-hours).
Plan-mode reviews
| Skill | What it does |
/office-hours | Start here. Reframes your product idea before you write code. |
/plan-ceo-review | CEO-level review: find the 10-star product in the request. |
/plan-eng-review | Lock architecture, data flow, edge cases, and tests. |
/plan-design-review | Rate each design dimension 0-10, explain what a 10 looks like. |
/plan-devex-review | DX-mode review: TTHW, magical moments, friction points, persona traces. |
/plan-tune | Self-tune AskUserQuestion sensitivity per question. |
/autoplan | One command runs CEO → design → eng → DX review. |
/design-consultation | Build a complete design system from scratch. |
/spec | Turn vague intent into a precise, executable spec in five phases. Files a GitHub issue, optionally spawns a Claude Code agent in a fresh worktree, and lets /ship close the source issue on merge. |
Implementation + review
| Skill | What it does |
/review | Pre-landing PR review. Finds bugs that pass CI but break in prod. |
/codex | Second opinion via OpenAI Codex. Review, challenge, or consult modes. |
/investigate | Systematic root-cause debugging. No fixes without investigation. |
/design-review | Live-site visual audit + fix loop with atomic commits. |
/design-shotgun | Generate multiple AI design variants, comparison board, iterate. |
/design-html | Generate production-quality Pretext-native HTML/CSS. |
/devex-review | Live developer experience audit (TTHW measured against the real flow). |
/qa | Open a real browser, find bugs, fix them, re-verify. |
/qa-only | Same methodology as /qa but report only — no code changes. |
/scrape | Pull data from a web page. First call prototypes; codified call runs in ~200ms. |
/skillify | Codify the most recent successful /scrape flow into a permanent browser-skill. |
Release + deploy
| Skill | What it does |
/ship | Run tests, review, push, open PR. Workspace-aware version queue. |
/land-and-deploy | Merge the PR, wait for CI and deploy, verify production health. |
/canary | Post-deploy monitoring loop using the browse daemon. |
/landing-report | Read-only dashboard for the workspace-aware ship queue. |
/document-release | Update all docs to match what you just shipped. |
/document-generate | Generate Diataxis docs (tutorial / how-to / reference / explanation) from code. |
/setup-deploy | One-time deploy config detection (Fly.io, Render, Vercel, etc.). |
/gstack-upgrade | Update gstack to the latest version. |
Operational + memory
| Skill | What it does |
/context-save | Save working context (git state, decisions, remaining work). |
/context-restore | Resume from a saved context, even across Conductor workspaces. |
/learn | Manage what gstack learned across sessions. |
/retro | Weekly retro with per-person breakdowns and shipping streaks. |
/health | Code quality dashboard (type checker, linter, tests, dead code). |
/benchmark | Performance regression detection (page load, Core Web Vitals). |
/benchmark-models | Cross-model benchmark for skills (Claude, GPT, Gemini side-by-side). |
/cso | OWASP Top 10 + STRIDE security audit. |
/setup-gbrain | Set up gbrain for cross-machine session memory sync. |
/sync-gbrain | Keep gbrain current with this repo's code; refresh agent search guidance in CLAUDE.md. |
Browser + agent integration
| Skill | What it does |
/browse | Headless browser — real Chromium, real clicks, ~100ms/command. |
/open-gstack-browser | Launch the visible GStack Browser with sidebar + stealth. |
/setup-browser-cookies | Import cookies from your real browser for authenticated testing. |
/pair-agent | Pair a remote AI agent (OpenClaw, Codex, etc.) with your browser. |
iOS QA — drive real iPhones over USB or Tailscale (v1.43.0.0+)
| Skill | What it does |
/ios-qa | Live-device iOS QA via USB CoreDevice tunnel + embedded StateServer. Optionally exposes the device over Tailscale so remote agents can drive it. |
/ios-fix | Autonomous iOS bug fixer with regression snapshot capture. |
/ios-design-review | Designer's-eye QA on a real iPhone — 10-dimension Apple HIG rubric. |
/ios-clean | Convenience: strip DebugBridge + #if DEBUG wiring before a Release build. |
/ios-sync | Regenerate the iOS debug bridge against the latest upstream templates. |
Companion CLIs (run on the Mac that's plugged into the device):
| Command | What it does |
gstack-ios-qa-daemon | Mac-side broker. Loopback by default; --tailnet adds a Tailscale-facing listener with capability tiers and audit logging. |
gstack-ios-qa-mint | Owner-grant CLI for the tailnet allowlist (grant/revoke/list). |
End-to-end walkthrough: docs/howto-ios-testing-with-gstack.md.
Safety + scoping
| Skill | What it does |
/careful | Warn before destructive commands (rm -rf, DROP TABLE, force-push). |
/freeze | Lock edits to one directory. Hard block, not just a warning. |
/guard | Activate both careful + freeze at once. |
/unfreeze | Remove directory edit restrictions. |
/make-pdf | Turn any markdown file into a publication-quality PDF. |
Build commands
bun install # install dependencies
bun test # run free tests (no API spend)
bun run test:windows # curated Windows-safe subset (runs on windows-latest)
bun run build # generate docs + compile binaries
bun run gen:skill-docs # regenerate SKILL.md files from templates
bun run skill:check # health dashboard for all skillsPlatform support
- macOS + Linux: full test suite supported.
- Windows: curated Windows-safe subset runs on
windows-latestvia thewindows-free-testsCI job. Setup script (./setup) requires Git Bash or MSYS today; native PowerShell support is a future expansion. Thebin/gstack-pathshelper resolves state roots throughCLAUDE_PLUGIN_DATA/GSTACK_HOMEso plugin installs work on every platform.
Key conventions
- SKILL.md files are generated from
.tmpltemplates. Edit the template, not the output. - Run
bun run gen:skill-docs --host codexto regenerate Codex-specific output. - The browse binary provides headless browser access. Use
$B <command>in skills. - Safety skills (careful, freeze, guard) use inline advisory prose — always confirm before destructive operations.
- State paths resolve via
bin/gstack-paths(sourced viaeval "$(...)"). HonorsGSTACK_HOME,CLAUDE_PLUGIN_DATA,CLAUDE_PLANS_DIR. - The
claudeCLI binary resolves viabrowse/src/claude-bin.ts(Bun.which()+GSTACK_CLAUDE_BINoverride). SetGSTACK_CLAUDE_BIN=wslplusGSTACK_CLAUDE_BIN_ARGS='["claude"]'to run Claude through WSL on Windows.
Other versions2 projects use a version of this.
Word for word · 2
- davidanthonyn/claude-skills★ 0100% same
- Saqlain-811/Claude-Skills★ 0100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.
Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.
In this repository9 other files it gives its agents.
- obsidian-wiki/AGENTS.mdAGENTS.md
- gstack/CLAUDE.mdCLAUDE.md
- obsidian-wiki/CLAUDE.mdCLAUDE.md
- frontend-designSkill
- gstackSkill
- impeccableSkill
- interface-designSkill
- korean-humanizerSkill
- ui-ux-pro-maxSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.