Opencode

What it does

When your agent uses it

• Tasks that involve Pull requests
• Tasks that involve Refactoring

Example prompts

• “/opencode”

Requirements

• Node.js
• A credential in OPENROUTER_API_KEY

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

1. 1Verify tool readiness
2. 2For bounded tasks, use opencode run '...' (no pty needed).
3. 3For iterative tasks, start opencode with background=true, pty=true.
4. 4Monitor long tasks with process(action="poll"|"log").
5. 5If OpenCode asks for input, respond via process(action="submit", ...).
6. 6Exit with process(action="write", data="\x03") or process(action="kill").
7. 7Summarize file changes, test results, and next steps back to user.

What it can do on your machine

Read from SKILL.md and the folder at commit be46b39. 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

  Shell commands in SKILL.md call:

  • opencode
  • git
  • npm
  • brew

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • github.com

  Also links to:

  • opencode.ai

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • OPENROUTER_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Opencode loads about 1.8k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 582 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~49

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

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

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 RedWoodOG/Hermes-Desktop at commit be46b39, republished under its MIT licence (© RedWoodOG). 582 words, ~1,837 tokens.

name

opencode

description

Delegate coding tasks to OpenCode CLI agent for feature implementation, refactoring, PR review, and long-running autonomous sessions. Requires the opencode CLI installed and authenticated.

version

1.2.0

author

Hermes Agent

license

MIT

terminal(command="which -a opencode")
terminal(command="opencode --version")

terminal(command="$HOME/.opencode/bin/opencode run '...'", workdir="~/project", pty=true)

terminal(command="opencode run 'Add retry logic to API calls and update tests'", workdir="~/project")

terminal(command="opencode run 'Review this config for security issues' -f config.yaml -f .env.example", workdir="~/project")

terminal(command="opencode run 'Debug why tests fail in CI' --thinking", workdir="~/project")

terminal(command="opencode run 'Refactor auth module' --model openrouter/anthropic/claude-sonnet-4", workdir="~/project")

terminal(command="opencode", workdir="~/project", background=true, pty=true)
# Returns session_id

# Send a prompt
process(action="submit", session_id="<id>", data="Implement OAuth refresh flow and add tests")

# Monitor progress
process(action="poll", session_id="<id>")
process(action="log", session_id="<id>")

# Send follow-up input
process(action="submit", session_id="<id>", data="Now add error handling for token expiry")

# Exit cleanly — Ctrl+C
process(action="write", session_id="<id>", data="\x03")
# Or just kill the process
process(action="kill", session_id="<id>")

terminal(command="opencode -c", workdir="~/project", background=true, pty=true)  # Continue last session
terminal(command="opencode -s ses_abc123", workdir="~/project", background=true, pty=true)  # Specific session

terminal(command="opencode pr 42", workdir="~/project", pty=true)

terminal(command="REVIEW=$(mktemp -d) && git clone https://github.com/user/repo.git $REVIEW && cd $REVIEW && opencode run 'Review this PR vs main. Report bugs, security risks, test gaps, and style issues.' -f $(git diff origin/main --name-only | head -20 | tr '\n' ' ')", pty=true)

terminal(command="opencode run 'Fix issue #101 and commit'", workdir="/tmp/issue-101", background=true, pty=true)
terminal(command="opencode run 'Add parser regression tests and commit'", workdir="/tmp/issue-102", background=true, pty=true)
process(action="list")

terminal(command="opencode session list")

terminal(command="opencode stats")
terminal(command="opencode stats --days 7 --models anthropic/claude-sonnet-4")

terminal(command="opencode run 'Respond with exactly: OPENCODE_SMOKE_OK'")

© RedWoodOG, 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 skills/autonomous-ai-agents/opencode of RedWoodOG/Hermes-Desktop.

Open the folder on GitHubat commit be46b39

Used in 5 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in RedWoodOG/Hermes-Desktop, which our catalogue first saw on October 7, 2026.

• Tommy-yw/RunbookHermesskills/autonomous-ai-agents/opencode
• NousResearch/hermes-agentskills/autonomous-ai-agents/opencode
• johnson7788/MultiUserClawhermes-agent/skills/autonomous-ai-agents/opencode
• ArgentAIOS/argentos-coreskills/hermes/autonomous-ai-agents/opencodeskills/community/autonomous-ai-agents/opencode
• AtlasOmnia/donna-starterskills/autonomous-ai-agents/opencode