Tayhlow8/Caixa-D-gua-website-2026 / .agents/skills/gstack
gstack
FlaggedFast 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)
contrib/add-host/SKILL.md.tmpl
View on GitHub---
name: gstack-contrib-add-host
description: |
Contributor-only skill: create a new host config for gstack's multi-host system.
NOT installed for end users. Only usable from the gstack source repo.
triggers:
- add new host
- create host config
- contribute new agent host
---
# /gstack-contrib-add-host — Add a New Host
This skill helps contributors add support for a new AI coding agent to gstack.
## What you'll create
A single TypeScript file in `hosts/<name>.ts` that defines:
- CLI binary name for detection
- Skill directory paths (global + local)
- Frontmatter transformation rules
- Path and tool rewrites
- Runtime root symlink manifest
## Steps
### 1. Gather host info
Ask the contributor:
- What's the agent's name? (e.g., "OpenCode")
- What's the CLI binary? (e.g., "opencode")
- Where does it store skills globally? (e.g., "~/.config/opencode/skills/")
- Where does it store skills locally in a project? (e.g., ".opencode/skills/")
- What frontmatter fields does it support? (name + description is the minimum)
- Does it have its own tool names? (e.g., "exec" instead of "Bash")
### 2. Create the config file
Use `hosts/opencode.ts` as a reference. Create `hosts/<name>.ts` with the
gathered info. Follow the HostConfig interface in `scripts/host-config.ts`.
### 3. Register in index
Add the import and re-export in `hosts/index.ts`.
### 4. Add to .gitignore
Add `.<name>/` to `.gitignore`.
### 5. Generate and verify
```bash
bun run gen:skill-docs --host <name>
```
Check:
- Output exists at `.<name>/skills/gstack-*/SKILL.md`
- No `.claude/skills` path leakage
- Frontmatter matches expected format
### 6. Run tests
```bash
bun test test/gen-skill-docs.test.ts
```
All parameterized tests auto-include the new host.
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 |