Summary

This OpenCode plugin enhances AI agent skills by providing dynamic discovery, context injection, and automatic semantic matching, catering to users needing advanced capabilities beyond OpenCode's native skill support. It offers a robust way to manage and utilize reusable AI agent skills within the OpenCode environment, making skills persistent and discoverable even in long, compacted sessions.

How It Works

The plugin employs dynamic skill discovery across project, user, and plugin directories, prioritizing local overrides. Skills are injected into the conversation context using noReply: true and synthetic: true flags, ensuring persistence through OpenCode's context compaction mechanisms. It automatically monitors messages for semantic relevance to available skills, prompting the agent to use them. Skills are pre-loaded at session start and re-injected post-compaction for continuous availability. Optional integration with the Superpowers workflow is also supported, injecting specific prompts for that environment.

Quick Start & Requirements

• Requirements: OpenCode v1.0.110 or later.
• Installation: Add "opencode-agent-skills" to the plugin array in ~/.config/opencode/opencode.json. Pinning to a specific version (e.g., "opencode-agent-skills@0.7.0") is recommended for stability.
• Local Development: Clone the repository, run bun install, and create a symbolic link from the cloned src/plugin.ts to ~/.config/opencode/plugin/skills.ts.

Highlighted Details

• Dynamic skill discovery from multiple prioritized locations.
• Synthetic context injection for resilient, long-session skill availability.
• Automatic semantic matching of user messages to relevant skills.
• Optional integration with the Superpowers development workflow.
• Compatibility with existing Claude Code skills and plugins.

Maintenance & Community

This project is in maintenance mode, accepting bug fixes and minor improvements. New feature development is discouraged in favor of OpenCode's native skills support. No community links (e.g., Discord, Slack) are provided.

Licensing & Compatibility

Licensed under the MIT license, permitting commercial use and integration. The plugin is not officially affiliated with the OpenCode team.

Limitations & Caveats

The plugin is primarily for users requiring specific advanced behaviors (semantic matching, synthetic injection) not present in OpenCode's native skill support, which is now the recommended path for most users. Its maintenance status implies limited future development. Network issues with Hugging Face downloads may require configuring a mirror.