opencode-plugin-dev

Standardize OpenCode plugin development with export patterns and event hooks.

1|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/octave-commons/gates-of-aker --skill opencode-plugin-dev-octave-commons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opencode-plugin-dev
Source: https://github.com/octave-commons/gates-of-aker/tree/main/.opencode/skills.disabled/opencode-plugin-dev
Command: npx skills add https://github.com/octave-commons/gates-of-aker --skill opencode-plugin-dev-octave-commons

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode plugin development is complex, and this Skill provides a standardized pattern for building, exporting, and wiring plugins with event hooks, guiding developers through structure, lifecycle, and safety considerations.

Core Features & Use Cases

  • Provides a canonical plugin entry point that accepts a context and returns a hooks map.
  • Documents and exemplifies tool, session, file, and server event hooks to extend OpenCode behavior.
  • Includes a structured frontmatter requirement and optional resource directories for extended guidance.

Quick Start

Install and scaffold an OpenCode plugin in a local project and start testing in a dev environment.

Frequently Asked Questions about opencode-plugin-dev

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

FAQPage Schema
How do I structure an OpenCode plugin with event hooks?

OpenCode plugin development requires a canonical entry point that accepts a context and returns a hooks map, backed by a root SKILL.md file. This pattern standardizes wiring for tool, session, file, and server event hooks.

What lifecycles can I target when building OpenCode extensions?

OpenCode extensions can hook into tool, session, file, and server lifecycles. This allows you to intercept and modify behavior across different stages of the OpenCode event system.

How do I scaffold a plugin for local testing in an OpenCode sandbox?

You can scaffold an OpenCode plugin by creating a root SKILL.md with name and description, then installing it in a local project to start testing within a development sandbox environment.

Do I need TypeScript for OpenCode plugin development?

TypeScript is used for OpenCode plugin development to enforce standardized export patterns and hooks. It ensures type safety when defining the context and hooks map for the plugin entry point.

What optional resource directories are supported for OpenCode plugins?

OpenCode plugins support optional resource directories including scripts, references, and assets. These directories allow you to organize extended guidance and supplementary files alongside the root SKILL.md.

When should I use a standardized export pattern for OpenCode plugin development?

You should use a standardized export pattern when extending OpenCode behavior to manage complexity and ensure safety. It provides a consistent structure for lifecycle management and event hook integration.