OpenCode Dotfiles

19 AI agent skills for OpenCode — research, analysis, writing, and automation.

Focused on academic research methodology, systematic reviews, critical analysis, and developer productivity. Compatible with Claude Code, Cursor, and Windsurf.

Quick Start

# Clone
git clone https://github.com/YOUR_USER/opencode-dotfiles.git ~/.config/opencode

# Or install from current directory:
# Windows
.\install.ps1

# Linux/macOS
chmod +x install.sh && ./install.sh

Manual symlink:

# Linux/macOS
ln -s "$(pwd)/skills/literature-review" ~/.config/opencode/skills/

Skills (19)

Agents

• researcher — PhD-level subagent for academic research (auto-loads relevant skills)
• yolo — Primary agent with full permissions

MCP Servers

Setup

1. Copy .env.example to .env and fill in your API keys
2. Install MCP servers (clone to ./mcp-servers/ or adjust paths)
3. Copy opencode.jsonc.template to opencode.jsonc and configure
4. Run opencode

Required API Keys

• Tavily — web search
• Exa — semantic search

Structure

opencode-dotfiles/
├── opencode.jsonc.template   # Config template (env vars)
├── .env.example              # Environment variables reference
├── AGENTS.md                 # Agent instructions
├── SKILLS.md                 # Skill index
├── install.ps1               # Windows installer
├── install.sh                # Unix installer
├── agents/
│   ├── researcher.md         # Research subagent definition
│   └── yolo.md              # Full-access agent config
├── skills/                   # 19 skill directories
│   ├── literature-review/
│   │   └── SKILL.md
│   ├── systematic-review/
│   │   └── SKILL.md
│   └── ...
└── scripts/
    └── screenshot.ps1        # Screenshot + OCR utility

License

MIT