opencode-extras

Personal collection of custom OpenCode commands, modes, and skills, managed in a single repo and symlinked into ~/.config/opencode.

Structure

modes/      # Custom agent modes (.md files)
skills/     # Reusable skill instructions loaded on demand (SKILL.md files)
install.sh  # Symlinks files into ~/.config/opencode
remove.sh   # Removes those symlinks

Skills

Skills are loaded into a conversation on demand via the skill tool. Each skill lives in its own subdirectory under skills/ with a SKILL.md file.

Skill	Description
analyze-code	Analyzes codebase implementation details; dives into specific component details
git-commit	Creates a git commit with user approval and no AI attribution
research-code	Documents the codebase as-is for historical context
search-web	Researches questions using web search and returns sourced findings
using-git-worktrees	Creates isolated git worktrees with smart directory selection and safety verification
systematic-debugging	Forces root cause investigation before any fix is attempted; use for any bug or unexpected behavior
code-review	Dispatches a focused code reviewer subagent to evaluate a phase or feature against its requirements
receiving-code-review	Guides technical evaluation of incoming review feedback - verify before implementing, push back when wrong
finishing-development-branch	Verifies tests and presents structured merge/PR/discard options with worktree cleanup
using-skills	Establishes instruction priority and the rule for invoking skills before acting

Usage

Clone this repo anywhere, then run the install script:

./install.sh

The script requires ~/.config/opencode to already exist (i.e., opencode must be installed). It creates the modes and skills subdirectories as needed, then symlinks each file from this repo into the appropriate location. Running it again is safe — already-linked files are skipped, and stale symlinks pointing into this repo are cleaned up automatically.

To remove the symlinks:

./remove.sh

This only removes symlinks that point to files in this repo; any files that were not symlinked are left alone.