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

bin/dev-setup

View on GitHub
#!/usr/bin/env bash
# Set up gstack for local development — test skills from within this repo.
#
# Creates .claude/skills/gstack → (symlink to repo root) so Claude Code
# discovers skills from your working tree. Changes take effect immediately.
#
# Also copies .env from the main worktree if this is a Conductor workspace
# or git worktree (so API keys carry over automatically).
#
# Usage: bin/dev-setup       # set up
#        bin/dev-teardown    # clean up
set -e

REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"

# 1. Copy .env from main worktree (if we're a worktree and don't have one)
if [ ! -f "$REPO_ROOT/.env" ]; then
  MAIN_WORKTREE="$(git -C "$REPO_ROOT" worktree list --porcelain 2>/dev/null | head -1 | sed 's/^worktree //')"
  if [ -n "$MAIN_WORKTREE" ] && [ "$MAIN_WORKTREE" != "$REPO_ROOT" ] && [ -f "$MAIN_WORKTREE/.env" ]; then
    cp "$MAIN_WORKTREE/.env" "$REPO_ROOT/.env"
    echo "Copied .env from main worktree ($MAIN_WORKTREE)"
  fi
fi

# 2. Install dependencies
if [ ! -d "$REPO_ROOT/node_modules" ]; then
  echo "Installing dependencies..."
  (cd "$REPO_ROOT" && bun install)
fi

# 3. Create .claude/skills/ inside the repo
mkdir -p "$REPO_ROOT/.claude/skills"

# 4. Symlink .claude/skills/gstack → repo root
# This makes setup think it's inside a real .claude/skills/ directory
GSTACK_LINK="$REPO_ROOT/.claude/skills/gstack"
if [ -L "$GSTACK_LINK" ]; then
  echo "Updating existing symlink..."
  rm "$GSTACK_LINK"
elif [ -d "$GSTACK_LINK" ]; then
  echo "Error: .claude/skills/gstack is a real directory, not a symlink." >&2
  echo "Remove it manually if you want to use dev mode." >&2
  exit 1
fi
ln -s "$REPO_ROOT" "$GSTACK_LINK"

# 5. Run setup via the symlink so it detects .claude/skills/ as its parent
"$GSTACK_LINK/setup"

echo ""
echo "Dev mode active. Skills resolve from this working tree."
echo "Edit any SKILL.md and test immediately — no copy/deploy needed."
echo ""
echo "To tear down: bin/dev-teardown"
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