OpenCode Agents Hub

A collection of ready-to-use agents and skills for OpenCode to assist developers in their daily tasks.

🎯 Philosophy

• Generic — Works with any language, framework, or stack
• Context-aware — Relies on your project's AGENTS.md for specific conventions
• No vendor lock-in — Uses your configured model/provider
• Multilingual — Responds in your language

📦 Agents

Primary Agents (Tab to switch)

Agent	Description
dev-architect	Design implementation plans before coding. Think before you build.
debugger	Analyze errors and bugs. Diagnose without modifying code.

Subagents (@ mention)

Agent	Description
commit-writer	Generate commit messages following Conventional Commits.
code-review	Review code for bugs, security, performance, and best practices.
task-writer	Draft tasks/tickets from ideas or bugs. Concise and actionable.
pr-writer	Create pull requests on GitHub/GitLab with structured descriptions.
release-notes	Generate and publish release notes matching your project's style.

🧠 Skills

Skills are reusable knowledge that agents can load on demand.

Skill	Description
git-conventions	Conventional Commits, branch naming, PR standards, SemVer, changelog format.
context7-lookup	How to use Context7 MCP for up-to-date library documentation.

🚀 Installation

Recommended: Global Installation

# Clone the repository
git clone https://github.com/humanuoid/opencode-agents-hub.git
cd opencode-agents-hub

# Create symlinks to your global OpenCode config
ln -s $(pwd)/agent ~/.config/opencode/agent
ln -s $(pwd)/skill ~/.config/opencode/skill

Or manually copy the agent/ and skill/ folders to ~/.config/opencode/.

Alternative: Per-Project (Git Submodule)

# Add as submodule in your project
git submodule add https://github.com/humanuoid/opencode-agents-hub.git .opencode

# The agents and skills will be available only in this project

⚙️ Configuration

Models

Agents do not specify a model — they use your globally configured model or inherit from the invoking agent.

Configure your preferred model in ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "your-provider/your-model"
}

See docs/models-recommendation.md for model suggestions per task type.

Project Context

For best results, create an AGENTS.md file at the root of your project describing:

• Architecture and patterns used
• Conventions and coding standards
• Project structure
• Tech stack

See docs/AGENTS.template.md for a template.

📖 Usage

Primary Agents

Switch between primary agents with Tab:

build → dev-architect → debugger → build

Plan before coding:

[Tab to dev-architect]
> I need to add a payment system with Stripe

Debug an issue:

[Tab to debugger]
> I get this error: TypeError: Cannot read property 'id' of undefined
> [paste stack trace]

Subagents

Invoke subagents with @ mention:

@commit-writer              # Generate commit message for staged changes
@code-review                # Review staged changes
@code-review #42            # Review a specific PR
@task-writer <description>  # Create a task from an idea
@pr-writer                  # Create and publish a PR
@release-notes              # Create and publish a release

🔧 Customization

Override an Agent

Create a file with the same name in your project's .opencode/agent/ to override:

<!-- .opencode/agent/commit-writer.md -->
---
description: Custom commit writer for this project
mode: subagent
---

[Your custom instructions]

Extend with Project Rules

Add project-specific rules in your AGENTS.md — agents will respect them automatically.

📚 Documentation

• OpenCode Docs
• Agents Documentation
• Skills Documentation
• Model Recommendations
• AGENTS.md Template

🤝 Contributing

Contributions welcome! Please read AGENTS.md for conventions.

• Suggest improvements to existing agents
• Propose new agents or skills
• Report issues
• Share your custom agents

📄 License

MIT