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.