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.