opencode-plugin-dev

Guide developers in building OpenCode plugins with TypeScript and the official SDK.

1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/pantheon-org/opencode-plugins --skill opencode-plugin-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-plugin-dev
Source: https://github.com/pantheon-org/opencode-plugins/tree/main/.opencode/skills/opencode-plugin-dev
Command: npx skills add https://github.com/pantheon-org/opencode-plugins --skill opencode-plugin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? This skill provides a practical, opinionated guide to bootstrap, structure, and test OpenCode plugins developed with TypeScript and the official SDK.

## Core Features & Use Cases

  • Step-by-step plugin scaffolding covering plugin entry, hooks, tools, authentication providers, events, and testing.
  • Clear guidance on plugin distribution, versioning, and documentation practices.
  • Real-world scenario: starting a new plugin project and iterating from prototype to production with CI checks.

### Quick Start

  • Install dependencies with bun install
  • Use bun run generate:plugin <name> to scaffold a new plugin
  • Open the generated package to implement a minimal plugin, then run bun run pack to build/test

Frequently Asked Questions about opencode-plugin-dev

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

FAQPage Schema
How do I scaffold a new OpenCode plugin using TypeScript?

To scaffold an OpenCode plugin, install dependencies with bun install and run bun run generate:plugin <name> to generate the project skeleton. You can then implement your plugin logic and run bun run pack to build and test it.

What components are involved in OpenCode plugin architecture?

OpenCode plugin architecture involves structuring plugin entry points, hooks, tools, authentication providers, and events. The official SDK provides the necessary interfaces for implementing these components within your TypeScript project.

Does OpenCode plugin development require the official SDK?

Yes, building OpenCode plugins with TypeScript requires using the official SDK. It provides the foundational contracts and tooling needed to properly structure, test, and integrate plugin components like hooks and events.

How do I test and distribute an OpenCode plugin?

Testing and distributing OpenCode plugins involves running bun run pack to build, validating functionality through defined testing scenarios, and following established guidelines for plugin versioning, documentation, and distribution practices.

What is the best way to structure an OpenCode plugin for production?

The best way to structure an OpenCode plugin for production is to iterate from a minimal prototype using the SDK skeleton, then add authentication and event hooks while enforcing CI checks and following documentation and versioning best practices.