opencode-plugin-development

Develop OpenCode plugins with hooks, tools, and event handling.

1|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dzackgarza/ai --skill opencode-plugin-development-dzackgarza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-plugin-development
Source: https://github.com/dzackgarza/ai/tree/main/opencode/skills/opencode-plugin-development
Command: npx skills add https://github.com/dzackgarza/ai --skill opencode-plugin-development-dzackgarza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Builds OpenCode plugins to extend agent behavior via hooks, tools, and events.

Core Features & Use Cases

  • Lightweight plugin layer around the CLI that exposes hooks and tools.
  • Supports local and external plugins, plus MCP-wrapped integrations.
  • Use case: extend agent capabilities, customize prompts, and orchestrate tool pipelines.

Quick Start

Create a TypeScript file in the plugin directory exporting a named Plugin function, then restart OpenCode.

Frequently Asked Questions about opencode-plugin-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I develop OpenCode plugins to extend agent behavior?

You can develop OpenCode plugins by creating a TypeScript file that exports a named Plugin function with hooks and tools, then restarting OpenCode to load the extension and customize agent behavior.

What is the difference between local and external OpenCode plugins?

Local OpenCode plugins reside directly in the plugin directory for immediate use, while external plugins and MCP-wrapped integrations connect separate services to orchestrate tool pipelines and extend agent capabilities.

How do I add a SKILL.md frontmatter to validate OpenCode plugin discovery?

To validate OpenCode plugin discovery, include a SKILL.md frontmatter with a name and description, enforcing the CLI-first architecture required for the Tool layer and MCP integration to function correctly.

Can I use MCP integration with OpenCode hooks and tools?

Yes, OpenCode supports MCP integration alongside hooks and tools, allowing you to wrap external integrations and orchestrate tool pipelines through a CLI-first architecture that extends agent capabilities.

Does OpenCode plugin development require a CLI-first architecture?

Yes, OpenCode plugin development enforces a CLI-first architecture that routes through a Tool layer to MCP, ensuring lightweight plugin behavior extension and proper event handling.

Why are my OpenCode plugins not loading after creating the TypeScript file?

OpenCode plugins require a SKILL.md frontmatter with name and description for discovery validation, and the OpenCode application must be restarted after placing the TypeScript file in the plugin directory.