skills.rest
candradesm
candradesmCOMMUNITY
Explore all skills by this author →
GitHub

opencode-plugin

Load and debug OpenCode server and TUI plugins with validated configuration.

6|Updated Feb 3, 2026
Search Tags:#debugging#plugin#server#opencode#tui#plugin-development
One-click install
npx skills add https://github.com/candradesm/zsh-config --skill opencode-plugin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: opencode-plugin
Source: https://github.com/candradesm/zsh-config/tree/main/.config/opencode/skills/opencode-plugin
Command: npx skills add https://github.com/candradesm/zsh-config --skill opencode-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenCode plugin loading and debugging can be error-prone without a clear structure and guidance. This Skill provides a proven blueprint for ensuring plugins load correctly, differentiate server and TUI plugin behavior, and establish robust hooks for deployment and testing.

Core Features & Use Cases

  • Unified plugin model for server and TUI plugins with explicit event hooks and config loading.
  • Guided deployment and testing workflows to minimize silent failures and wasted hours.
  • Debugging guidance for common plugin load issues, including plugin registration and lifecycle management.

Quick Start

Place this Skill in your OpenCode configuration directory and load the environment to enable plugin loading and debugging workflows.

Frequently Asked Questions about opencode-plugin

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

FAQPage Schema
How do I debug an OpenCode plugin that fails to load?▼

To debug an OpenCode plugin that fails to load, you need to validate frontmatter and check plugin registration. This Skill provides debugging workflows for lifecycle management and configuration loading to resolve silent failures.

What is the correct structure for OpenCode server and TUI plugins?▼

The correct structure for OpenCode server and TUI plugins enforces a two-system plugin model with explicit event hooks. Frontmatter validation and unified config loading ensure reliable behavior across environments.

Does OpenCode plugin development work on macOS and Linux?▼

Yes, OpenCode plugin development works on macOS, Linux, and other supported environments. The plugin loading, registration, and debugging workflows apply cross-platform to ensure consistent behavior.

How do I set up deployment and testing workflows for OpenCode plugins?▼

To set up deployment and testing workflows for OpenCode plugins, establish explicit event hooks and lifecycle management. Guided workflows enforce frontmatter validation to minimize silent failures during deployment.

Why is my OpenCode plugin not registering its hooks properly?▼

OpenCode plugins fail to register hooks properly when the two-system plugin structure is incorrect or frontmatter validation fails. Enforcing lifecycle management and config loading resolves these registration issues.

Related Skills

Explore More Software Engineering Skills→
CharitablebusinessroninCharitablebusinessronin

plugin-creator

Create OpenCode plugins and configure their project/global load locations.

Community
Intermediate
nsalvacaonsalvacao

hook-development

Implement Claude Code plugin hooks to validate tool use and automate event-driven workflows.

Community
Advanced
Tashima-TarshTashima-Tarsh
1

Hook Development

Implement custom event-driven hooks for Claude Code plugin workflows.

Community
Advanced
rsicarellirsicarelli
63

compilation-error-analyzer

Diagnose Fakt compilation errors and classify root causes in Kotlin/Gradle workflows.

Community
Advanced