opencode-conflict-prevention

Explain OpenCode plugin loading priority, deduplication, and naming conventions.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guidelines to prevent conflicts when OpenCode plugins load, deduplicate, and name plugins, reducing integration issues during plugin development and publishing.

Core Features & Use Cases

  • Plugin Loading Priority: Later sources override earlier ones to ensure predictable behavior.
  • Deduplication Mechanism: Same plugin name from different sources is collapsed to a single winner by priority.
  • Naming Conventions: Use scoped names and descriptive identifiers to minimize conflicts.
  • Common Conflict Scenarios: Local vs npm, duplicate names, hook conflicts, with recommended resolutions.
  • Troubleshooting Conflicts: Diagnosis steps and checks to isolate issues.
  • Publishing Guidelines: Before publishing, test for conflicts and document compatibility.
  • Best Practices: Documentation, testing, and safe hooks.

Quick Start

Review the guidelines and apply the loading priority, deduplication rules, and naming recommendations when developing or publishing OpenCode plugins.

Frequently Asked Questions about opencode-conflict-prevention

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

FAQPage Schema
How does OpenCode plugin loading priority work across local, project, global, and npm sources?

OpenCode plugin loading priority ensures later sources override earlier ones, so plugins from npm or global sources take precedence over local or project sources to maintain predictable behavior.

How do I prevent duplicate OpenCode plugin names from causing conflicts?

To prevent duplicate OpenCode plugin name conflicts, the deduplication mechanism collapses same-name plugins from different sources into a single winner determined by the loading priority rules.

What naming conventions should I follow when publishing an OpenCode plugin?

When publishing an OpenCode plugin, use scoped names and descriptive identifiers as naming conventions to minimize conflicts and ensure compatibility across different plugin sources.

Why do my OpenCode plugin hooks conflict during local development versus npm installation?

OpenCode plugin hook conflicts between local development and npm installation occur due to overlapping sources, which can be resolved by checking loading priority and applying deduplication rules.

How do I troubleshoot OpenCode plugin conflicts during integration?

To troubleshoot OpenCode plugin conflicts, follow the diagnosis steps to isolate issues by checking loading priority, verifying deduplication winners, and reviewing naming conventions for duplicate identifiers.

Do I need to test for OpenCode plugin conflicts before publishing to npm?

Yes, before publishing an OpenCode plugin to npm, you must test for conflicts, document compatibility, and verify that your naming conventions and hooks follow safe publishing guidelines.