Skip to content

Tayhlow8/Caixa-D-gua-website-2026 / .agents/skills/gstack

gstack

Flagged

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

FileKindSize
AGENTS.mdmarkdown2.5 KB
ARCHITECTURE.mdmarkdown29.3 KB
BROWSER.mdmarkdown29.2 KB
CHANGELOG.mdmarkdown389.3 KB
CLAUDE.mdmarkdown40.4 KB
CONTRIBUTING.mdmarkdown21.4 KB
DESIGN.mdmarkdown4.4 KB
ETHOS.mdmarkdown7.3 KB
LICENSEother1.0 KB
README.mdmarkdown37.3 KB
SKILL.mdskill md40.7 KB
SKILL.md.tmplother10.9 KB
TODOS.mdmarkdown79.0 KB
USING_GBRAIN_WITH_GSTACK.mdmarkdown19.0 KB
VERSIONother9 B
actionlint.yamlconfig56 B
agents/openai.yamlconfig351 B
bin/chrome-cdpother2.2 KB
bin/dev-setupother2.4 KB
bin/dev-teardownother1.6 KB
bin/gstack-analyticsother6.3 KB
bin/gstack-brain-consumerother5.5 KB
bin/gstack-brain-enqueueother1.9 KB
bin/gstack-brain-initother13.8 KB
bin/gstack-brain-readerother21 B
bin/gstack-brain-restoreother7.5 KB
bin/gstack-brain-syncother14.6 KB
bin/gstack-brain-uninstallother5.2 KB
bin/gstack-builder-profileother616 B
bin/gstack-codex-probeother4.5 KB
bin/gstack-community-dashboardother4.5 KB
bin/gstack-configother10.4 KB
bin/gstack-developer-profileother15.9 KB
bin/gstack-diff-scopeother3.1 KB
bin/gstack-extensionother2.0 KB
bin/gstack-gbrain-detectother3.6 KB
bin/gstack-gbrain-installother6.6 KB
bin/gstack-gbrain-lib.shscript3.4 KB
bin/gstack-gbrain-repo-policyother7.0 KB
bin/gstack-gbrain-supabase-provisionother15.2 KB
bin/gstack-gbrain-supabase-verifyother4.0 KB
bin/gstack-global-discover.tsscript18.8 KB
bin/gstack-jsonl-mergeother2.7 KB
bin/gstack-learnings-logother3.3 KB
bin/gstack-learnings-searchother4.8 KB
bin/gstack-model-benchmarkother5.8 KB
bin/gstack-next-versionother16.3 KB
bin/gstack-open-urlother338 B
bin/gstack-patch-namesother1.2 KB
bin/gstack-platform-detectother1.0 KB
bin/gstack-question-logother6.4 KB
bin/gstack-question-preferenceother9.4 KB
bin/gstack-relinkother3.0 KB
bin/gstack-repo-modeother3.5 KB
bin/gstack-review-logother866 B
bin/gstack-review-readother528 B
bin/gstack-security-dashboardother4.9 KB
bin/gstack-session-updateother3.5 KB
bin/gstack-settings-hookother2.8 KB
bin/gstack-slugother1.9 KB
bin/gstack-specialist-statsother2.2 KB
bin/gstack-taste-updateother10.5 KB
bin/gstack-team-initother6.7 KB
bin/gstack-telemetry-logother10.0 KB
bin/gstack-telemetry-syncother5.3 KB
bin/gstack-timeline-logother1.6 KB
bin/gstack-timeline-readother2.6 KB
bin/gstack-uninstallother10.3 KB
bin/gstack-update-checkother7.7 KB
bun.lockother57.4 KB
claude/SKILL.md.tmplother8.7 KB
conductor.jsonconfig87 B
connect-chromeother19 B
contrib/add-host/SKILL.md.tmplother1.7 KB
design/prototype.tsscript5.4 KB
design/src/auth.tsscript1.7 KB
design/src/brief.tsscript1.9 KB
design/src/check.tsscript3.3 KB
design/src/cli.tsscript8.9 KB
design/src/commands.tsscript3.0 KB
design/src/compare.tsscript19.1 KB
design/src/design-to-code.tsscript3.0 KB
design/src/diff.tsscript3.3 KB
design/src/evolve.tsscript5.3 KB
design/src/gallery.tsscript7.0 KB
design/src/generate.tsscript4.4 KB
design/src/iterate.tsscript6.5 KB
design/src/memory.tsscript6.0 KB
design/src/serve.tsscript8.3 KB
design/src/session.tsscript1.8 KB
design/src/variants.tsscript8.7 KB
design/test/feedback-roundtrip.test.tsscript12.6 KB
design/test/gallery.test.tsscript5.0 KB
design/test/serve.test.tsscript16.0 KB
docs/ADDING_A_HOST.mdmarkdown6.1 KB
docs/ON_THE_LOC_CONTROVERSY.mdmarkdown13.2 KB
docs/OPENCLAW.mdmarkdown6.5 KB
docs/REMOTE_BROWSER_ACCESS.mdmarkdown9.6 KB
docs/designs/BUN_NATIVE_INFERENCE.mdmarkdown6.7 KB
docs/designs/CHROME_VS_CHROMIUM_EXPLORATION.mdmarkdown4.0 KB
docs/designs/CONDUCTOR_CHROME_SIDEBAR_INTEGRATION.mdmarkdown3.5 KB
docs/designs/CONDUCTOR_SESSION_API.mdmarkdown3.9 KB
docs/designs/DESIGN_SHOTGUN.mdmarkdown22.5 KB
docs/designs/DESIGN_TOOLS_V1.mdmarkdown36.0 KB
docs/designs/GCOMPACTION.mdmarkdown57.6 KB
docs/designs/GSTACK_BROWSER_V0.mdmarkdown17.3 KB
docs/designs/ML_PROMPT_INJECTION_KILLER.mdmarkdown20.7 KB
docs/designs/PACING_UPDATES_V0.mdmarkdown9.7 KB
docs/designs/PLAN_TUNING_V0.mdmarkdown31.2 KB
docs/designs/PLAN_TUNING_V1.mdmarkdown19.0 KB
docs/designs/SELF_LEARNING_V0.mdmarkdown15.4 KB
docs/designs/SESSION_INTELLIGENCE.mdmarkdown6.8 KB
docs/designs/SIDEBAR_MESSAGE_FLOW.mdmarkdown10.1 KB
docs/designs/SLATE_HOST.mdmarkdown12.6 KB
docs/designs/SLOP_SCAN_FOR_REVIEW_SHIP.mdmarkdown3.0 KB
docs/evals/security-bench-ensemble-v2.jsonconfig1.6 KB
docs/gbrain-sync-errors.mdmarkdown6.2 KB
docs/gbrain-sync.mdmarkdown6.5 KB
docs/images/github-2013.pngbinary61.9 KB
docs/images/github-2026.pngbinary59.1 KB
docs/skills.mdmarkdown59.5 KB
extension/background.jsscript20.6 KB
extension/content.cssother2.5 KB
extension/content.jsscript11.9 KB
extension/icons/icon-128.pngbinary2.8 KB
extension/icons/icon-16.pngbinary400 B
extension/icons/icon-48.pngbinary1.1 KB
extension/inspector.cssother798 B
extension/inspector.jsscript15.7 KB
extension/lib/xterm-addon-fit.jsscript1.5 KB
extension/lib/xterm.cssother5.3 KB
extension/lib/xterm.jsscript276.8 KB
extension/manifest.jsonconfig783 B
extension/popup.htmlother2.3 KB
extension/popup.jsscript1.7 KB
extension/sidepanel-terminal.jsscript15.2 KB
extension/sidepanel.cssother39.6 KB
extension/sidepanel.htmlother9.1 KB
extension/sidepanel.jsscript40.2 KB
hosts/claude.tsscript1.1 KB
hosts/codex.tsscript2.2 KB
hosts/cursor.tsscript1.1 KB
hosts/factory.tsscript1.8 KB
hosts/gbrain.tsscript2.2 KB
hosts/hermes.tsscript2.1 KB
hosts/index.tsscript2.2 KB
hosts/kiro.tsscript1.2 KB
hosts/openclaw.tsscript2.0 KB
hosts/opencode.tsscript1.3 KB
hosts/slate.tsscript1.1 KB
lib/worktree.tsscript9.6 KB
model-overlays/claude.mdmarkdown613 B
model-overlays/gemini.mdmarkdown551 B
model-overlays/gpt-5.4.mdmarkdown683 B
model-overlays/gpt.mdmarkdown1.9 KB
model-overlays/o-series.mdmarkdown660 B
model-overlays/opus-4-7.mdmarkdown1.5 KB
openclaw/agents-gstack-section.mdmarkdown2.5 KB
openclaw/gstack-full-CLAUDE.mdmarkdown538 B
openclaw/gstack-lite-CLAUDE.mdmarkdown688 B
openclaw/gstack-plan-CLAUDE.mdmarkdown1.0 KB
package.jsonmanifest4.7 KB
scripts/analytics.tsscript5.3 KB
scripts/app/gstack-browserother2.4 KB
scripts/app/icon.icnsother1.0 MB
scripts/archetypes.tsscript5.4 KB
scripts/build-app.shscript7.5 KB
scripts/compare-pr-version.tsscript3.0 KB
scripts/detect-bump.tsscript1.2 KB
scripts/dev-skill.tsscript2.4 KB
scripts/discover-skills.tsscript1.2 KB
scripts/eval-compare.tsscript3.0 KB
scripts/eval-list.tsscript3.5 KB
scripts/eval-select.tsscript3.1 KB
scripts/eval-summary.tsscript6.5 KB
scripts/eval-watch.tsscript5.4 KB
scripts/garry-output-comparison.tsscript17.0 KB
scripts/gen-skill-docs.tsscript28.3 KB
scripts/host-adapters/openclaw-adapter.tsscript1.7 KB
scripts/host-config-export.tsscript3.4 KB
scripts/host-config.tsscript7.3 KB
scripts/jargon-list.jsonconfig1.8 KB
scripts/models.tsscript2.5 KB
scripts/one-way-doors.tsscript5.6 KB
scripts/preflight-agent-sdk.tsscript4.4 KB
scripts/psychographic-signals.tsscript10.3 KB
scripts/question-registry.tsscript23.5 KB
scripts/resolvers/browse.tsscript6.2 KB
scripts/resolvers/codex-helpers.tsscript5.0 KB
scripts/resolvers/composition.tsscript1.8 KB
scripts/resolvers/confidence.tsscript1.6 KB
scripts/resolvers/constants.tsscript3.1 KB
scripts/resolvers/design.tsscript56.9 KB
scripts/resolvers/dx.tsscript5.4 KB
scripts/resolvers/gbrain.tsscript5.3 KB
scripts/resolvers/index.tsscript4.3 KB
scripts/resolvers/learnings.tsscript3.9 KB
scripts/resolvers/make-pdf.tsscript2.2 KB
scripts/resolvers/model-overlay.tsscript2.2 KB
scripts/resolvers/preamble.tsscript5.7 KB

scripts/host-config.ts

View on GitHub
/**
 * Declarative host config system.
 *
 * Each supported host (Claude, Codex, Factory, OpenCode, OpenClaw, etc.) is
 * defined as a typed HostConfig object in hosts/*.ts. This module provides
 * the interface, loader, and validator.
 *
 * Architecture:
 *   hosts/*.ts  →  hosts/index.ts  →  host-config.ts (this file)
 *        │                                    │
 *        └── typed configs ──────────────────→ consumed by gen-skill-docs.ts,
 *                                              setup (via host-config-export.ts),
 *                                              skill-check.ts, worktree.ts,
 *                                              platform-detect, uninstall
 */

export interface HostConfig {
  /** Unique host identifier (e.g., 'opencode'). Must match filename in hosts/. */
  name: string;
  /** Human-readable name for UI/logs (e.g., 'OpenCode'). */
  displayName: string;
  /** Binary name for `command -v` detection (e.g., 'opencode'). */
  cliCommand: string;
  /** Alternative binary names (e.g., ['droid'] for factory). */
  cliAliases?: string[];

  // --- Path Configuration ---
  /** Global install path relative to $HOME (e.g., '.config/opencode/skills/gstack'). */
  globalRoot: string;
  /** Project-local skill path relative to repo root (e.g., '.opencode/skills/gstack'). */
  localSkillRoot: string;
  /** Gitignored directory under repo root for generated docs (e.g., '.opencode'). */
  hostSubdir: string;
  /** Whether preamble generates $GSTACK_ROOT env vars (true for non-Claude hosts). */
  usesEnvVars: boolean;

  // --- Frontmatter Transformation ---
  frontmatter: {
    /** 'allowlist': ONLY keepFields survive. 'denylist': strip listed fields. */
    mode: 'allowlist' | 'denylist';
    /** Fields to preserve (allowlist mode only). */
    keepFields?: string[];
    /** Fields to remove (denylist mode only). */
    stripFields?: string[];
    /** Max chars for description field. null = no limit. */
    descriptionLimit?: number | null;
    /** What to do when description exceeds limit. Default: 'error'. */
    descriptionLimitBehavior?: 'error' | 'truncate' | 'warn';
    /** Additional frontmatter fields to inject (host-wide). */
    extraFields?: Record<string, unknown>;
    /** Rename fields from template (e.g., { 'voice-triggers': 'triggers' }). */
    renameFields?: Record<string, string>;
    /** Conditionally add fields based on template frontmatter values. */
    conditionalFields?: Array<{ if: Record<string, unknown>; add: Record<string, unknown> }>;
  };

  // --- Generation ---
  generation: {
    /** Whether to create sidecar metadata file (e.g., openai.yaml for Codex). */
    generateMetadata: boolean;
    /** Metadata file format (e.g., 'openai.yaml'). */
    metadataFormat?: string | null;
    /** Skill directories to exclude from generation for this host. */
    skipSkills?: string[];
    /** Skill directories to include (allowlist). Union logic: include minus skip. */
    includeSkills?: string[];
  };

  // --- Content Rewrites ---
  /** Literal string replacements on generated SKILL.md content. Order matters, replaceAll. */
  pathRewrites: Array<{ from: string; to: string }>;
  /** Tool name string replacements on content. */
  toolRewrites?: Record<string, string>;
  /** Resolver functions that return empty string for this host. */
  suppressedResolvers?: string[];

  // --- Runtime Root ---
  runtimeRoot: {
    /** Explicit asset list for global install symlinks (no globs). */
    globalSymlinks: string[];
    /** Dir → explicit file list for selective file linking. */
    globalFiles?: Record<string, string[]>;
  };
  /** Optional repo-local sidecar config (e.g., Codex uses .agents/skills/gstack). */
  sidecar?: {
    /** Sidecar path relative to repo root (e.g., '.agents/skills/gstack'). */
    path: string;
    /** Assets to symlink into sidecar (different set than global). */
    symlinks: string[];
  };

  // --- Install Behavior ---
  install: {
    /** Whether gstack-config skill_prefix applies (Claude only). */
    prefixable: boolean;
    /** How skills are linked into the host dir. */
    linkingStrategy: 'real-dir-symlink' | 'symlink-generated';
  };

  // --- Host-Specific Behavioral Config ---
  /** Git co-author trailer string. */
  coAuthorTrailer?: string;
  /** Learnings implementation: 'full' = cross-project, 'basic' = simple. */
  learningsMode?: 'full' | 'basic';
  /** Anti-prompt-injection boundary instruction for cross-model invocations. */
  boundaryInstruction?: string;

  /** Static files to copy alongside generated skills (e.g., { 'SOUL.md': 'openclaw/SOUL.md' }). */
  staticFiles?: Record<string, string>;
  /** Optional path to host-adapter module for complex transformations. */
  adapter?: string;
}

// --- Validation ---

const NAME_REGEX = /^[a-z][a-z0-9-]*$/;
const PATH_REGEX = /^[a-zA-Z0-9_.\/${}~-]+$/;
const CLI_REGEX = /^[a-z][a-z0-9_-]*$/;

export function validateHostConfig(config: HostConfig): string[] {
  const errors: string[] = [];

  if (!NAME_REGEX.test(config.name)) {
    errors.push(`name '${config.name}' must be lowercase alphanumeric with hyphens`);
  }
  if (!config.displayName) {
    errors.push('displayName is required');
  }
  if (!CLI_REGEX.test(config.cliCommand)) {
    errors.push(`cliCommand '${config.cliCommand}' contains invalid characters`);
  }
  if (config.cliAliases) {
    for (const alias of config.cliAliases) {
      if (!CLI_REGEX.test(alias)) {
        errors.push(`cliAlias '${alias}' contains invalid characters`);
      }
    }
  }
  if (!PATH_REGEX.test(config.globalRoot)) {
    errors.push(`globalRoot '${config.globalRoot}' contains invalid characters`);
  }
  if (!PATH_REGEX.test(config.localSkillRoot)) {
    errors.push(`localSkillRoot '${config.localSkillRoot}' contains invalid characters`);
  }
  if (!PATH_REGEX.test(config.hostSubdir)) {
    errors.push(`hostSubdir '${config.hostSubdir}' contains invalid characters`);
  }
  if (!['allowlist', 'denylist'].includes(config.frontmatter.mode)) {
    errors.push(`frontmatter.mode must be 'allowlist' or 'denylist'`);
  }
  if (!['real-dir-symlink', 'symlink-generated'].includes(config.install.linkingStrategy)) {
    errors.push(`install.linkingStrategy must be 'real-dir-symlink' or 'symlink-generated'`);
  }

  return errors;
}

export function validateAllConfigs(configs: HostConfig[]): string[] {
  const errors: string[] = [];

  // Per-config validation
  for (const config of configs) {
    const configErrors = validateHostConfig(config);
    errors.push(...configErrors.map(e => `[${config.name}] ${e}`));
  }

  // Cross-config uniqueness checks
  const hostSubdirs = new Map<string, string>();
  const globalRoots = new Map<string, string>();
  const names = new Map<string, string>();

  for (const config of configs) {
    if (names.has(config.name)) {
      errors.push(`Duplicate name '${config.name}' (also used by ${names.get(config.name)})`);
    }
    names.set(config.name, config.name);

    if (hostSubdirs.has(config.hostSubdir)) {
      errors.push(`Duplicate hostSubdir '${config.hostSubdir}' (${config.name} and ${hostSubdirs.get(config.hostSubdir)})`);
    }
    hostSubdirs.set(config.hostSubdir, config.name);

    if (globalRoots.has(config.globalRoot)) {
      errors.push(`Duplicate globalRoot '${config.globalRoot}' (${config.name} and ${globalRoots.get(config.globalRoot)})`);
    }
    globalRoots.set(config.globalRoot, config.name);
  }

  return errors;
}
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