Skip to content

opencode-setup.md

Latest commit

 

History

History
83 lines (55 loc) · 2.36 KB

opencode-setup.md

File metadata and controls

83 lines (55 loc) · 2.36 KB
Raw

OpenCode Setup

OpenCode uses a skill-driven execution model via the skill tool and AGENTS.md discovery.

Install

OpenCode auto-discovers skills from ./skills/ relative to your project root, or globally from ~/.opencode/skills/.

🟢 Path 1: Symlink into ~/.opencode/skills/

git clone https://github.com/ravidsrk/agent-skills.git
mkdir -p ~/.opencode/skills
for s in agent-skills/skills/*/; do
  name=$(basename "$s")
  ln -sf "$(pwd)/$s" "$HOME/.opencode/skills/$name"
done

🟢 Path 2: Project-local

Inside any OpenCode project:

git clone https://github.com/ravidsrk/agent-skills.git .opencode/agent-skills
ln -s .opencode/agent-skills/skills .opencode/skills

Repo-level AGENTS.md

This repo ships an AGENTS.md at the root. OpenCode reads it automatically when you open the agent-skills folder — it tells OpenCode:

  1. Which skills exist
  2. Which user intents map to which skill
  3. The mandatory rule: "if a task matches a skill, you MUST invoke it"

If you only want the skills (not the AGENTS.md rules), copy the skills/ directory and ignore the root AGENTS.md.

Env vars

OpenCode inherits from the shell. Set in ~/.zshrc / ~/.bashrc:

export CLOUDFLARE_API_KEY=cfat_...
export NAMECHEAP_API_KEY=...
export NAMECHEAP_API_USER=your-account
export MONID_API_KEY=...
export OPENROUTER_API_KEY=...
export AWS_PROFILE=migration
export FLY_API_TOKEN=...

Verify activation

In OpenCode, send a request matching a skill's triggers:

"Migrate my Fly project to AWS"

OpenCode should invoke the skill tool with fly-to-aws-migration and follow the workflow.

How OpenCode reads skills

OpenCode's flow:

  1. Read AGENTS.md at project root → understands the skill mapping rules
  2. Read skills/<name>/SKILL.md when a skill is invoked → loads the workflow
  3. Execute scripts in skills/<name>/scripts/ as needed
  4. Load references/ progressively when the workflow points to them

🟢 Progressive disclosure works out of the box — OpenCode won't load references/gotchas.md until the skill workflow actually references it.

Updating

cd /path/to/agent-skills && git pull

Symlinks update automatically.

See also