plan-eng-review
garrytan/gstackTesting & QACoding & code reviewProduct & project management
plan-eng-review is a skill in garrytan/gstack, last changed 19 Nov 2026. It can run shell commands, reach the network, name web addresses, pre-approve tools and run commands as it loads — read the findings before installing.
Use when you plan a feature before building it, or review a plan: locks in architecture, data flow, diagrams, edge cases, test coverage and performance. Use for: plan a feature, review architecture, eng plan review. (gstack)
At a glance
What it can touch
- Runs shell commands
- Reaches the network
- Names web addresses
- Pre-approves tools
- Runs commands as it loads
How much a skill can do, not whether it is risky.
Pattern check:2 items to reviewSee them
QAI Index
We rate every listed skill the same way, from 0 to 100.
A guide to compare by, not a verdict on the skill.
How it's scoredGet an email when its check changes.
Keep it with the other skills you use, installed with one command.
Install
Sign in to see how to install it
Free with Google or an email link, no password needed. Then pick your agent and copy its steps.
What it can touch
Sign in to see the file and line behind each one
The summary at the top stays open to everyone. Signing in is free, with Google or an email link.
Pattern check
Pattern check: 2 items to review · commit 0adfab9 · 20 Nov 2026
We checked every text file in this skill, at commit 0adfab9 on 20 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.
How the check worksReport an incorrect finding
Outside links we did not follow
- https://gstack.dev/schemas/section-manifest.json
- https://github.com/garrytan/gstack/blob/main/docs/model-policy.md
Format check
Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.
Agent Skills specPasses with warnings
The format our Agent Skills docs set out, held to the strictest version of each rule among the agents we check.
- Warning
Fields outside the spec: preamble-tier, version and triggers. Uploads to the Claude apps and API, and strict validators, reject the file; most agents ignore these fields. O1
Fix: Delete them for a portable skill, or keep them if you only target the agents that read them.
- Warning
allowed-tools is a list; the spec defines a space-separated string. gh skill publish rejects a list, though Claude Code accepts one. O5
Fix: Write it on one line: allowed-tools: Read Write Grep Glob AskUserQuestion Bash WebSearch Bash(~/.claude/skills/gstack/bin/gstack-skill-load:*)
- Warning
The body is 536 lines; the spec suggests under 500. B1
Fix: Move detailed sections into reference files and link to them from SKILL.md.
- Warning
The body is about 10,263 tokens (approx.); the spec suggests under 5,000. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
There is no license field, so readers can't tell whether they may reuse the skill. O2
Fix: Add license: with an SPDX name such as MIT or Apache-2.0, or the name of a bundled licence file.
- Note
Reference files that SKILL.md doesn't link: sections/checklist.md. Anthropic suggests linking every reference file directly from SKILL.md. B4
Fix: Link each one from SKILL.md and say when to read it.
- Note
Reference files over 100 lines with no table of contents at the top: sections/preamble.md (262 lines) and sections/review-sections.md (1551 lines). B5
Fix: Add a short list of the sections at the top of each.
- Warning
Claude CodePasses
Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.
- Note
Claude Code ignores fields it doesn't know: preamble-tier, version and triggers. O1
Fix: Check the spelling against Claude Code's field list, or delete them.
- Note
The body is 536 lines; the spec suggests under 500. Claude Code's docs say the same. B1
Fix: Move detailed sections into reference files and link to them from SKILL.md.
- Note
The body is about 10,263 tokens (approx.); the spec suggests under 5,000. After compaction Claude Code keeps only the first 5,000 tokens of a skill. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
Reference files that SKILL.md doesn't link: sections/checklist.md. Anthropic suggests linking every reference file directly from SKILL.md. B4
Fix: Link each one from SKILL.md and say when to read it.
- Note
Reference files over 100 lines with no table of contents at the top: sections/preamble.md (262 lines) and sections/review-sections.md (1551 lines). B5
Fix: Add a short list of the sections at the top of each.
- Note
Claude apps & API uploadFails
Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.
- Error
Upload and packaging fail on fields outside the spec: preamble-tier, version and triggers. O1
Fix: Delete them, and keep your own data under metadata as text values.
- Note
The description is 224 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4
Fix: If the claude.ai upload refuses it, trim the description to 200 characters.
- Note
allowed-tools is a list; the spec defines a space-separated string. O5
Fix: Write it on one line: allowed-tools: Read Write Grep Glob AskUserQuestion Bash WebSearch Bash(~/.claude/skills/gstack/bin/gstack-skill-load:*)
- Note
The body is 536 lines; the spec suggests under 500. Anthropic's guidance says the same. B1
Fix: Move detailed sections into reference files and link to them from SKILL.md.
- Note
The body is about 10,263 tokens (approx.); the spec suggests under 5,000. Anthropic's guidance says the same. B2
Fix: Move detail into reference files that the agent reads only when needed.
- Note
Reference files that SKILL.md doesn't link: sections/checklist.md. Anthropic suggests linking every reference file directly from SKILL.md. B4
Fix: Link each one from SKILL.md and say when to read it.
- Note
Reference files over 100 lines with no table of contents at the top: sections/preamble.md (262 lines) and sections/review-sections.md (1551 lines). B5
Fix: Add a short list of the sections at the top of each.
- Error
OpenAI (Codex & API)Passes with warnings
Codex finds SKILL.md by its exact name and needs a description; OpenAI's Skills API checks the frontmatter against the spec and caps uploads.
- Warning
Fields outside the spec: preamble-tier, version and triggers. Codex ignores them; OpenAI doesn't say whether its upload accepts them. O1
Fix: Delete them, or move your own data under metadata as text values.
- Note
allowed-tools is a list; the spec defines a space-separated string. O5
Fix: Write it on one line: allowed-tools: Read Write Grep Glob AskUserQuestion Bash WebSearch Bash(~/.claude/skills/gstack/bin/gstack-skill-load:*)
- Warning
VS Code & CopilotPasses
VS Code reads skills one folder below .github/skills, .claude/skills or .agents/skills and falls back to the folder name when the name is missing or differs; GitHub's Copilot docs require the exact name SKILL.md.
- Note
VS Code ignores fields it doesn't support: preamble-tier, version and triggers. O1
Fix: Delete them unless another agent you target reads them.
- Note
allowed-tools is a list; the spec defines a space-separated string. O5
Fix: Write it on one line: allowed-tools: Read Write Grep Glob AskUserQuestion Bash WebSearch Bash(~/.claude/skills/gstack/bin/gstack-skill-load:*)
- Note
SKILL.md
Files
8 files
Changelog
Newest first: each commit that changed its folder on GitHub, and each change to its listing here.
- Updated: Telemetry records why skill runs end, which host and model ran them, … (9ea26ec (opens in a new tab))
- Updated: Claude Code skills run their start step as they load, so it can't be … (7f9c1bc (opens in a new tab))
- Updated: Say when to use each gstack skill in Claude Code's skill list (GST-27… (ab114c5 (opens in a new tab))
- Updated: Ask each question once and check every handed-over file, in every ski… (a141e94 (opens in a new tab))
- Updated: Make gstack agents lead every report with what failed, what's unverif… (76fad3e (opens in a new tab))
- Updated: Load the never-print-secrets rule in every skill on every host, with … (28822af (opens in a new tab))
- Updated: Count an outside review as clean only when it ends with a VERDICT lin… (7cb151b (opens in a new tab))
- Updated: v1.93.6.0 feat: /plan-tune learns from ad-hoc question ids that carry… (5209e92 (opens in a new tab))
- Updated: v1.92.15.0 feat: plan reviews check facts and keep one task list; /of… (8695938 (opens in a new tab))
- Updated: v1.92.6.0 feat: proactive core routes only the four core skills, and … (ed10791 (opens in a new tab))
- Updated: v1.91.309.0 fix(flaky): one rule each in the judged review and Eng pr… (043feff (opens in a new tab))
- Updated: v1.91.281.0 fix(flaky): repair four paid gate detectors, the design-f… (392f50d (opens in a new tab))
- Listed on QAI
QAI Index badge
Show this skill's QAI Index in a README or on a website. It links back to this page and changes when we refresh the catalog.
[](https://qai.io/skills/garrytan/gstack/plan-eng-review)More from garrytan/gstack
| Skill | QAI Index | What it can touch | Pattern check | Licence | Updated |
|---|---|---|---|---|---|
autoplanAuto-review pipeline — runs the CEO, design, eng and DX reviews in order (lean run: one reviewer), auto-deciding. Use for: run all reviews, automatic review pipeline. (gstack) 70/QI
Pattern check: 3 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 3 items to review | MIT | 19 Nov 2026 |
benchmarkWeb performance regression detection. Use for: web performance benchmark, check page speed. (gstack) 70/QI
Pattern check: 2 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 2 items to review | MIT | 19 Nov 2026 |
benchmark-modelsCross-model benchmark for gstack skills. Use for: cross model benchmark, compare claude gpt gemini. (gstack) 70/QI
Pattern check: 2 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 2 items to review | MIT | 19 Nov 2026 |
canaryPost-deploy canary monitoring. Use for: monitor after deploy, canary check. (gstack) 70/QI
Pattern check: 3 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 3 items to review | MIT | 19 Nov 2026 |
captainRun a crew of coding agents from one controller (also /crew): lanes send READY blocks and never merge; the controller merges through trains, keeps the digest, relays approvals, fixes flakes daily. Use for: captain, crew. (gstack) 70/QI
Pattern check: 3 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 3 items to review | MIT | 19 Nov 2026 |
codexOpenAI Codex CLI wrapper — three modes. Use for: codex review, second opinion, outside voice challenge. (gstack) 70/QI
Pattern check: 3 items to reviewMITUpdated 19 Nov 2026 | 70/QI |
| Pattern check: 3 items to review | MIT | 19 Nov 2026 |
Other Testing & QA skills
Same category, most repo stars first.