medvedych/opencode-conf
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
5 commits 1 branch 0 tags 54 KiB
Find a file
Exact
Denis Fedoseev 4b432abec0 Fix perltidy typo in perl skill
2026-08-20 04:21:05 +03:00
.opencode Fix perltidy typo in perl skill 2026-08-20 04:21:05 +03:00
.perltidyrc adds base perltidyrc 2026-08-19 03:22:01 +03:00
AGENTS.md Initial commit 2026-08-19 03:19:12 +03:00
opencode.jsonc Allow read-only bash commands for code-review agent 2026-08-20 04:16:44 +03:00
README.md Initial commit 2026-08-19 03:19:12 +03:00

README.md

opencode Configuration Template

A self-contained, reusable opencode configuration for a project. Copy the .opencode/ directory, opencode.jsonc, and AGENTS.md into any repository to get the same agents, skills, and conventions.

Layout

opencode.jsonc                  # project config (schema, instructions, extension points)
AGENTS.md                       # instructions loaded into the primary agent
.opencode/
  agents/
    code-review.md              # reviews diffs for correctness/security/style
    techwriter.md               # writes and improves documentation
    software-architect.md       # designs systems and documents decisions
  skills/
    perl/SKILL.md               # Perl best practices
    postgresql/SKILL.md         # PostgreSQL schema, queries, operations
    docker/SKILL.md             # Dockerfiles, Compose, image operations

Quick start

  1. Copy opencode.jsonc, AGENTS.md, and .opencode/ into the target repo.
  2. Fill in the About this repository and Conventions sections of AGENTS.md.
  3. Restart opencode. Config is loaded once at startup and is not hot-reloaded.

Extending

Want to add… Do this
A subagent Create .opencode/agents/<name>.md
A skill Create .opencode/skills/<name>/SKILL.md
A command Create .opencode/command/<name>.md
Shared team skills Add a path under skills.paths in opencode.jsonc
Tighter permissions Edit the permission block in opencode.jsonc
More context Add entries to instructions in opencode.jsonc

Subagent file

---
description: One sentence on what it does and when to use it.
mode: subagent
permission:
  edit: deny
---

The prompt. The file body becomes the agent's system prompt.

Skill file

---
name: my-skill
description: One sentence covering what it does AND when to trigger it.
---

# My Skill

Markdown guidance. Front-load trigger keywords in the description.

Conventions

  • Agents and skills live as files, not inline in opencode.jsonc, so they are easy to diff, review, and reuse.
  • opencode.jsonc carries only the schema, the instructions entry, and commented extension points. Keep it lean.
  • The software-architect subagent references the software-architecture skill when it is available (bundled separately in the global config).
  • After any change to a config-time file, restart opencode to apply it.

Reference