Tuios
Gaurav-Gosain/tuios
Drive tuios from inside one of its panes. An agent skill from Gaurav-Gosain/tuios.
Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes.
MITAuto-check passed
Install Gaia Harness Engineering
$ npx skills add amd/gaia --skill gaia-harness-engineering -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install amd/gaia gaia-harness-engineering --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .claude/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .claude/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineeringType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add amd/gaia --skill gaia-harness-engineering -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install amd/gaia gaia-harness-engineering --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .agents/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .agents/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .agents/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add amd/gaia --skill gaia-harness-engineering -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install amd/gaia gaia-harness-engineering --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .cursor/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .cursor/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/amd/gaia.git --path hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add amd/gaia --skill gaia-harness-engineering -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install amd/gaia gaia-harness-engineering --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .gemini/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .gemini/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install amd/gaia gaia-harness-engineeringInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add amd/gaia --skill gaia-harness-engineering -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .github/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .github/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .github/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add amd/gaia --skill gaia-harness-engineering -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install amd/gaia gaia-harness-engineering --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/amd/gaia.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering .opencode/skills/gaia-harness-engineering && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gaia-harness-engineering" agent skill from https://github.com/amd/gaia/tree/main/hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering into .opencode/skills/gaia-harness-engineering/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gaia-harness-engineering", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gaia-harness-engineering- GitHub stars
- 1.6k
- Token cost
- ~882 tokens
- SKILL.md length
- 468 words
- Files
- 1
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- MIT
At a glance
Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes.
- Works in 9 steps: Clarify expected and observed behavior.… → Select claude or codex with the… → Give the developer the job ID and… → …
- Tasks that involve Git worktrees
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Gaia Harness Engineering is an agent skill from amd/gaia. Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes.
Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It works with Model Context Protocol. The repository describes itself as: Build AI agents for your PC. The licence is MIT.
When your agent uses it
- Tasks that involve Git worktrees
Example prompts
- “/gaia-harness-engineering”
Workflow steps
9 steps, taken from the first numbered list in SKILL.md.
- Clarify expected and observed behavior. Use engineering_status without a
- Select claude or codex with the developer. Prepare a concise summary and
- Give the developer the job ID and connection instructions. Use
- Diagnose before editing: reproduce safely using synthetic or read-only
- After diagnosis, use approve_engineering_code to request worktree scope.
- Have the coding app launch a separate agent/TUI/WebUI preview with isolated
- Use engineering_status for reported progress and preview details. Clearly
- Review all outgoing public text, code and commit history. Generalize private
- revoke_engineering_context stops future bridge reads. Already delivered
What it can do on your machine
Read from SKILL.md and the folder at commit 05fb50b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Gaia Harness Engineering loads about 882 tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 468 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from amd/gaia at commit 05fb50b, republished under its MIT licence (© amd). 468 words, ~882 tokens.
Download SKILL.mdSave it as
.claude/skills/gaia-harness-engineering/SKILL.md (or your agent's skills folder).- name
- gaia-harness-engineering
- description
- Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes.
Developer handoff
This skill is enabled by the host only in developer mode. Start only when the developer reports a problem or requests an improvement. Do not automatically assess friction or start coding. Keep GAIA available for daily work.
- Clarify expected and observed behavior. Use
engineering_statuswithout a job ID to inspect source-cache initialization and coding-app setup. Surface failures and connection instructions; do not claim connection or task launch merely because the app exists. - Select
claudeorcodexwith the developer. Prepare a concise summary and selected evidence. Do not collect entire histories, unrelated files or credentials.share_engineering_contextshows the exact summary and context and requests fresh approval before the selected coding app can read them. The app may use a cloud provider; its existing filesystem permissions remain independent of this bridge. Never use shell, file tools or another MCP tool to bypass this approval. Bypass-permissions mode cannot approve sharing. - Give the developer the job ID and connection instructions. Use
open_engineering_apponly when asked to open the app. An opened app or prefilled composer is not a submitted or running task. The developer may interact directly in their existing coding app. For Codex specifically, opening only brings the app forward: it does not create a task, select a folder or prefill a composer. Say this explicitly, then show the returned directory and exact prompt to paste into a new task. Never say "posted to Codex", "sent", or "look for the prefilled composer". A generated MCP config is not an installed or verified client connection. - Diagnose before editing: reproduce safely using synthetic or read-only inputs, inspect configuration/model limits and actual build identities, check releases and existing issues/PRs. Do not replay destructive tools or external sends. Recommend a model/configuration change when evidence supports it; ask before changing the user's model. Unknown root cause stays unknown.
- After diagnosis, use
approve_engineering_codeto request worktree scope. All edits must be in an isolated worktree from the managed GAIA cache. Private snapshots stay outside Git; they must not become fixtures or commits. - Have the coding app launch a separate agent/TUI/WebUI preview with isolated
writable state, ports and explicit build revision. A worktree is not a
security sandbox. Let the developer test and iterate. Share additional
feedback only through
append_engineering_context, which asks again. - Use
engineering_statusfor reported progress and preview details. Clearly distinguish app-reported results from locally verified checks. Native app conversations and detailed coding remain in that app. - Review all outgoing public text, code and commit history. Generalize private examples. Workflow approval does not make raw context safe to publish. Follow repository contribution/review requirements; maintainers own merge.
revoke_engineering_contextstops future bridge reads. Already delivered data cannot be recalled. Stable release updates are a separate feature; never replace the running GAIA installation from a preview worktree.
© amd, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering of amd/gaia.
Open the folder on GitHubat commit 05fb50b
Compare with similar skills
Gaia Harness Engineering next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gaia Harness Engineering this skillamd/gaia | 1.6k | — | ~882 | Automated safety check: Pass | MIT | |
| TuiosGaurav-Gosain/tuios | 5k | — | ~3.7k | Automated safety check: Pass | MIT | |
| E2EAgentsMesh/AgentsMesh | 2.4k | — | ~629 | Automated safety check: Notes | Custom licence | |
| Agent Deckasheshgoplani/agent-deck | 1k | — | ~1.7k | Automated safety check: Pass | MIT | |
| Puppetmaster Agent Orchestrationprofessorpalmer/Puppetmaster | 467 | — | ~3.2k | Automated safety check: Pass | MIT | |
| Agent Manager Fleet TUIYoanWai/agent-manager | 576 | — | ~1k | Automated safety check: Pass | Apache-2.0 |
Similar skills
E2E
AgentsMesh/AgentsMesh
Selects and runs the appropriate AgentsMesh end-to-end suite for Web, Desktop, MCP, or iOS, including worktree-specific environment setup and browser-level verification.
Agent Deck
asheshgoplani/agent-deck
agent-deck, the terminal session manager for AI coding agents.
Puppetmaster Agent Orchestration
professorpalmer/Puppetmaster
Operates and supervises Puppetmaster, a multi-agent orchestrator, through its MCP tools or CLI, picking the right verb for edits, reviews, audits and long-running jobs.
Agent Manager Fleet TUI
YoanWai/agent-manager
Runs several coding-agent CLIs as real tmux sessions in one terminal UI, color-coded by whether each is working, waiting, idle or blocked.
Agtx Task Sweep
fynnfluegge/agtx
Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.
More from amd/gaia
All 44 skills in this repoGAIA Agent Eval Scorecard
amd/gaia
Adds a release eval scorecard to a GAIA hub agent by writing a harness adapter, running a real eval, and wiring the result into the agent's README and release gate.
GAIA Sidecar Agent Release
amd/gaia
Walks through releasing a GAIA sidecar agent as a frozen binary plus npm client through the tag-triggered Agent Hub CI pipeline, with a human gate before publishing.
Analyzing Claude Code Sessions
amd/gaia
Mines local Claude Code session transcripts with a deterministic Python pipeline to show what the agent is actually used for, how often it fails and what it costs.
GAIA Agent Benchmarking
amd/gaia
Benchmarks AMD's GAIA agent against Claude Code and across models on quality, honesty, steps, tokens, time and real cost, using gaia eval tasks.
Verified Coding Workflow
amd/gaia
Guides safe code changes by finding the right file with grep or semantic search, reading before editing, reproducing bugs first, and proving a fix with a real test run.
GAIA Agent Builder
amd/gaia
Walks through scaffolding, writing and testing a new GAIA agent as a Python class with the SDK, from the base Agent subclass to registered tool methods.
Related
Works with
Questions about Gaia Harness Engineering
What does Gaia Harness Engineering do?
Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes. Gaia Harness Engineering is an agent skill from amd/gaia. Help a developer report a GAIA TUI, WebUI or agent problem, explicitly share a snapshot with Claude Code or Codex through MCP, and validate isolated worktree fixes.
When should I use Gaia Harness Engineering?
Gaia Harness Engineering fits situations like: tasks that involve Git worktrees.
How do I install Gaia Harness Engineering in Claude Code?
Run `npx skills add amd/gaia --skill gaia-harness-engineering -a claude-code`. Or copy the skill folder (hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering in amd/gaia) into .claude/skills/gaia-harness-engineering in your project. Claude Code loads it when a task matches its description.
How do I install Gaia Harness Engineering in Codex?
Run `npx skills add amd/gaia --skill gaia-harness-engineering -a codex`. Or copy the skill folder (hub/agents/gaia/python/gaia_agent/skills/gaia-harness-engineering in amd/gaia) into .agents/skills/gaia-harness-engineering in your project. Codex loads it when a task matches its description.
Can I use Gaia Harness Engineering in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add amd/gaia --skill gaia-harness-engineering -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gaia-harness-engineering, .gemini/skills/gaia-harness-engineering, .github/skills/gaia-harness-engineering and .opencode/skills/gaia-harness-engineering in your project.
What does Gaia Harness Engineering need to run?
SKILL.md names no scripts, command-line tools or credentials: Gaia Harness Engineering is instructions for the agent only.
Does Gaia Harness Engineering access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Gaia Harness Engineering safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Gaia Harness Engineering use?
Gaia Harness Engineering is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Gaia Harness Engineering use?
About 882 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Gaia Harness Engineering?
Skills that share tags, products or a category with Gaia Harness Engineering: Tuios (Gaurav-Gosain/tuios, 5k stars), E2E (AgentsMesh/AgentsMesh, 2.4k stars), Agent Deck (asheshgoplani/agent-deck, 1k stars) and Puppetmaster Agent Orchestration (professorpalmer/Puppetmaster, 467 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gaia Harness Engineering?
amd (a GitHub organization) maintains it in amd/gaia, which has 1,580 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 8, 2026.
Source: amd/gaia on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.