# Oh My Opencode Slim

Configure and improve oh-my-opencode-slim for the current user.

- Repository: https://github.com/alvinunreal/oh-my-opencode-slim (10062 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add alvinunreal/oh-my-opencode-slim --skill oh-my-opencode-slim -g -a claude-code -y`
Codex: `npx skills add alvinunreal/oh-my-opencode-slim --skill oh-my-opencode-slim -g -a codex -y`
Cursor: `npx skills add alvinunreal/oh-my-opencode-slim --skill oh-my-opencode-slim -g -a cursor -y`
Gemini CLI: `npx skills add alvinunreal/oh-my-opencode-slim --skill oh-my-opencode-slim -g -a gemini-cli -y`

## Description

Configure and improve oh-my-opencode-slim for the current user. Use when users want to tune agents, models, prompts, custom agents, skills, MCPs, presets, or plugin behavior. Also use when recurring workflow friction suggests a safe config or prompt improvement.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# oh-my-opencode-slim Configuration Skill

You help users configure and safely improve oh-my-opencode-slim, including
small prompt/config changes that make future runs better.

## When to Use

Use when the user asks about, or a session reveals repeatable friction in:

- plugin config (`oh-my-opencode-slim.json[c]`), presets, models/variants
- delegation behavior, specialist prompts, custom agents (`agents.<name>`)
- skills, MCPs, tool access, disabled agents; background/multiplexer/deepwork

Suggest config changes only for recurring behavior, not one-offs.

## Files

- User config: `~/.config/opencode/oh-my-opencode-slim.jsonc` (preferred) or `.json`; project override: `<project>/.opencode/oh-my-opencode-slim.json`.
- Prompt tuning: `~/.config/opencode/oh-my-opencode-slim/{agent}[_append].md` (prefer `_append.md`; preset variant under `{preset}/`).
- Skill shadow: `~/.config/opencode/skills/<skill-name>/SKILL.md` shadows the bundled skill.
- Agent names: `orchestrator|oracle|explorer|designer|fixer|observer|council`.

Lookup: with an active preset, check `{preset}/` first, then the base dir.
`{agent}.md` replaces the built-in prompt; `{agent}_append.md` appends to it. Each works alone; neither present → unchanged built-in prompt.

Common customizations:

- Presets/models: switch preset; cheaper models for `explorer`/`fixer`, stronger ones for `orchestrator`/`oracle`/`designer`.
- Permissions: per-agent `skills`/`mcps` (`['*']`, names, or `['*', '!x']`); enable optional agents by removing them from `disabled_agents`.
- Custom agents under `agents.<name>` with `prompt` plus `orchestratorPrompt` (trigger and non-use).
- Prompt tuning via `{agent}_append.md` for recurring behavior or house style.

Important schema boundary:

The rest: https://github.com/alvinunreal/oh-my-opencode-slim/blob/HEAD/src/skills/oh-my-opencode-slim/SKILL.md