alexandervashurin/semaphore / .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. gstack also includes development workflow skills. When you notice the user is at these stages, suggest the appropriate skill: - Brainstorming a new idea → suggest /office-hours - Reviewing a plan (strategy) → suggest /plan-ceo-review - Reviewing a plan (architecture) → suggest /plan-eng-review - Reviewing a plan (design) → suggest /plan-design-review - Creating a design system → suggest /design-consultation - Debugging errors → suggest /investigate - Testing the app → suggest /qa - Code review before merge → suggest /review - Visual design audit → suggest /design-review - Ready to deploy / create PR → suggest /ship - Post-ship doc updates → suggest /document-release - Weekly retrospective → suggest /retro - Wanting a second opinion or adversarial code review → suggest /codex - Working with production or live systems → suggest /careful - Want to scope edits to one module/directory → suggest /freeze - Maximum safety mode (destructive warnings + edit restrictions) → suggest /guard - Removing edit restrictions → suggest /unfreeze - Upgrading gstack to latest version → suggest /gstack-upgrade If the user pushes back on skill suggestions ("stop suggesting things", "I don't need suggestions", "too aggressive"): 1. Stop suggesting for the rest of this session 2. Run: gstack-config set proactive false 3. Say: "Got it — I'll stop suggesting skills. Just tell me to be proactive again if you change your mind." If the user says "be proactive again" or "turn on suggestions": 1. Run: gstack-config set proactive true 2. Say: "Proactive suggestions are back on."
scripts/dev-skill.ts
View on GitHub#!/usr/bin/env bun
/**
* dev:skill — Watch mode for SKILL.md template development.
*
* Watches .tmpl files, regenerates SKILL.md files on change,
* validates all $B commands immediately.
*/
import { validateSkill } from '../test/helpers/skill-parser';
import { execSync } from 'child_process';
import * as fs from 'fs';
import * as path from 'path';
const ROOT = path.resolve(import.meta.dir, '..');
const TEMPLATES = [
{ tmpl: path.join(ROOT, 'SKILL.md.tmpl'), output: 'SKILL.md' },
{ tmpl: path.join(ROOT, 'browse', 'SKILL.md.tmpl'), output: 'browse/SKILL.md' },
];
function regenerateAndValidate() {
// Regenerate
try {
execSync('bun run scripts/gen-skill-docs.ts', { cwd: ROOT, stdio: 'pipe' });
} catch (err: any) {
console.log(` [gen] ERROR: ${err.stderr?.toString().trim() || err.message}`);
return;
}
// Validate each generated file
for (const { output } of TEMPLATES) {
const fullPath = path.join(ROOT, output);
if (!fs.existsSync(fullPath)) continue;
const result = validateSkill(fullPath);
const totalValid = result.valid.length;
const totalInvalid = result.invalid.length;
const totalSnapErrors = result.snapshotFlagErrors.length;
if (totalInvalid > 0 || totalSnapErrors > 0) {
console.log(` [check] \u274c ${output} (${totalValid} valid)`);
for (const inv of result.invalid) {
console.log(` Unknown command: '${inv.command}' at line ${inv.line}`);
}
for (const se of result.snapshotFlagErrors) {
console.log(` ${se.error} at line ${se.command.line}`);
}
} else {
console.log(` [check] \u2705 ${output} — ${totalValid} commands, all valid`);
}
}
}
// Initial run
console.log(' [watch] Watching *.md.tmpl files...');
regenerateAndValidate();
// Watch for changes
for (const { tmpl } of TEMPLATES) {
if (!fs.existsSync(tmpl)) continue;
fs.watch(tmpl, () => {
console.log(`\n [watch] ${path.relative(ROOT, tmpl)} changed`);
regenerateAndValidate();
});
}
// Also watch commands.ts and snapshot.ts (source of truth changes)
const SOURCE_FILES = [
path.join(ROOT, 'browse', 'src', 'commands.ts'),
path.join(ROOT, 'browse', 'src', 'snapshot.ts'),
];
for (const src of SOURCE_FILES) {
if (!fs.existsSync(src)) continue;
fs.watch(src, () => {
console.log(`\n [watch] ${path.relative(ROOT, src)} changed`);
regenerateAndValidate();
});
}
// Keep alive
console.log(' [watch] Press Ctrl+C to stop\n');
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |