opencode-plugin-compliance

Enforce OpenCode plugin compliance with hook-based architecture and safety constraints.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/shynlee04/idumb-plugin --skill opencode-plugin-compliance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-plugin-compliance
Source: https://github.com/shynlee04/idumb-plugin/tree/main/.claude/skills/opencode-plugin-compliance
Command: npx skills add https://github.com/shynlee04/idumb-plugin --skill opencode-plugin-compliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

OpenCode plugin compliance ensures that plugin developers follow the official hook-based architecture and safety constraints to preserve security, stability, and predictable behavior across the platform.

Core Features & Use Cases

  • Hook-driven architecture enforcement: plugins may only act at predefined extension points and must export a Plugin function to participate in the lifecycle.
  • Event subscriptions, tool interception, and permission handling: plugins can observe and influence events, intercept tool execution, automate permission decisions, while never directly mutating core state.
  • SDK usage and storage boundaries: plugins must use the official SDK for logging and interactions, and adhere to storage access rules to prevent direct file system manipulation.
  • Reference integration: consult references/hooks.md and references/events.md for complete interface definitions and examples of compliant implementations.

Quick Start

Create a minimal compliant plugin by exporting a Plugin function that wires the required hooks, then validate conformance with the OpenCode platform checks.

Frequently Asked Questions about opencode-plugin-compliance

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

FAQPage Schema
How do I ensure my OpenCode plugin complies with hook-based architecture and safety constraints?▼

OpenCode plugin compliance is enforced by validating that plugins export a Plugin function, adhere to predefined extension points, and avoid direct core state mutation. This SDK-driven approach ensures predictable behavior across the full plugin lifecycle.

What are the storage and permission boundaries for OpenCode plugin development?▼

OpenCode plugin permission handling requires plugins to use the official SDK for interactions and automate permission decisions without directly manipulating file system storage. Plugins must observe read-only event access and respect strict storage boundaries to maintain platform security.

How do I intercept tool execution and subscribe to events in an OpenCode plugin?▼

Event subscriptions and tool interception in OpenCode plugins let you observe and influence lifecycle events at predefined hooks. Plugins must export a Plugin function wiring these hooks, ensuring read-only event access without directly mutating core state.

Why does my OpenCode plugin validation fail during the lifecycle export checks?▼

OpenCode plugin validation fails when plugins lack explicit export shapes, attempt direct storage manipulation, or bypass SDK-driven logging. Compliance requires adhering to hook definitions, avoiding direct file system manipulation, and following official interaction patterns across the lifecycle.

Do I need the official SDK to handle logging and interactions for OpenCode plugin compliance?▼

Yes, OpenCode plugin compliance requires using the official SDK for logging and interactions. Plugins must adhere to SDK-driven patterns and storage access rules to prevent direct file system manipulation and ensure safe, predictable platform behavior.