umairinayat/Specter-AI / .claude/skills/gstack
gstack
FlaggedFast headless browser for QA testing and site dogfooding. Navigate any URL, interact with elements, verify page state, diff before/after actions, take annotated screenshots, check responsive layouts, test forms and uploads, handle dialogs, and assert element states. ~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a user flow, or file a bug with evidence.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 171 B |
| .github/workflows/skill-docs.yml | config | 365 B |
| .gitignore | other | 127 B |
| ARCHITECTURE.md | markdown | 13.9 KB |
| BROWSER.md | markdown | 13.8 KB |
| CHANGELOG.md | markdown | 14.0 KB |
| CONTRIBUTING.md | markdown | 10.2 KB |
| LICENSE | other | 1.0 KB |
| README.md | markdown | 29.2 KB |
| SKILL.md | skill md | 12.5 KB |
| SKILL.md.tmpl | other | 6.1 KB |
| TODO.md | markdown | 6.9 KB |
| TODOS.md | markdown | 1.8 KB |
| VERSION | other | 6 B |
| bin/dev-setup | other | 1.9 KB |
| bin/dev-teardown | other | 946 B |
| bin/gstack-update-check | other | 3.0 KB |
| conductor.json | config | 87 B |
| package.json | manifest | 1.6 KB |
| scripts/dev-skill.ts | script | 2.4 KB |
| scripts/gen-skill-docs.ts | script | 7.6 KB |
| scripts/skill-check.ts | script | 3.7 KB |
| setup | other | 2.8 KB |
| test/gen-skill-docs.test.ts | script | 6.2 KB |
| test/helpers/session-runner.ts | script | 5.0 KB |
| test/helpers/skill-parser.ts | script | 3.4 KB |
| test/skill-e2e.test.ts | script | 6.2 KB |
| test/skill-llm-eval.test.ts | script | 8.2 KB |
| test/skill-parser.test.ts | script | 5.3 KB |
| test/skill-validation.test.ts | script | 5.9 KB |
TODOS.md
View on GitHub# TODOS
## Auto-upgrade mode (zero-prompt)
**What:** Add a `GSTACK_AUTO_UPGRADE=1` env var or `~/.gstack/config` option that skips the AskUserQuestion prompt and upgrades automatically when a new version is detected.
**Why:** Power users and CI environments may want zero-friction upgrades without being asked every time.
**Context:** The current upgrade system (v0.3.4) always prompts via AskUserQuestion. This TODO adds an opt-in bypass. Implementation is ~10 lines in the preamble instructions: check for the env var/config before calling AskUserQuestion, and if set, go straight to the upgrade flow. Depends on the full upgrade system being stable first — wait for user feedback on the prompt-based flow before adding this.
**Effort:** S (small)
**Priority:** P3 (nice-to-have, revisit after adoption data)
## Convert remaining skills to .tmpl files
**What:** Convert ship/, review/, plan-ceo-review/, plan-eng-review/, retro/ SKILL.md files to .tmpl templates using the `{{UPDATE_CHECK}}` placeholder.
**Why:** These 5 skills still have the update check preamble copy-pasted. When the preamble changes (like the `|| true` fix in v0.3.5), all 5 need manual updates. The `{{UPDATE_CHECK}}` resolver already exists in `scripts/gen-skill-docs.ts` — these skills just need to be converted.
**Context:** The browse-using skills (SKILL.md, browse/, qa/, setup-browser-cookies/) were converted to .tmpl in v0.3.5. The remaining 5 skills only use `{{UPDATE_CHECK}}` (no `{{BROWSE_SETUP}}`), so the conversion is mechanical: replace the preamble with `{{UPDATE_CHECK}}`, add the path to `findTemplates()` in `scripts/gen-skill-docs.ts`, and commit both .tmpl + generated .md.
**Depends on:** v0.3.5 shipping first (the `{{UPDATE_CHECK}}` resolver).
**Effort:** S (small, ~20 min)
**Priority:** P2 (prevents drift on next preamble change)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |