Skip to content

umairinayat/Specter-AI / .claude/skills/gstack

gstack

Flagged

Fast 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.

FileKindSize
.env.exampleother171 B
.github/workflows/skill-docs.ymlconfig365 B
.gitignoreother127 B
ARCHITECTURE.mdmarkdown13.9 KB
BROWSER.mdmarkdown13.8 KB
CHANGELOG.mdmarkdown14.0 KB
CONTRIBUTING.mdmarkdown10.2 KB
LICENSEother1.0 KB
README.mdmarkdown29.2 KB
SKILL.mdskill md12.5 KB
SKILL.md.tmplother6.1 KB
TODO.mdmarkdown6.9 KB
TODOS.mdmarkdown1.8 KB
VERSIONother6 B
bin/dev-setupother1.9 KB
bin/dev-teardownother946 B
bin/gstack-update-checkother3.0 KB
conductor.jsonconfig87 B
package.jsonmanifest1.6 KB
scripts/dev-skill.tsscript2.4 KB
scripts/gen-skill-docs.tsscript7.6 KB
scripts/skill-check.tsscript3.7 KB
setupother2.8 KB
test/gen-skill-docs.test.tsscript6.2 KB
test/helpers/session-runner.tsscript5.0 KB
test/helpers/skill-parser.tsscript3.4 KB
test/skill-e2e.test.tsscript6.2 KB
test/skill-llm-eval.test.tsscript8.2 KB
test/skill-parser.test.tsscript5.3 KB
test/skill-validation.test.tsscript5.9 KB

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');
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall