# opencode-agent-skills

A dynamic skills plugin for OpenCode that provides tools for loading and using reusable AI agent skills.

> [!NOTE] > OpenCode now includes first-party support for agent skills, including native skill discovery and a built-in `skill` tool. For most users, this plugin is no longer necessary. It remains available in maintenance mode for users who depend on its extra behavior, such as automatic semantic skill matching, synthetic context injection, compaction reinjection, Superpowers bootstrapping, and helper tools for reading skill files or running skill scripts.

## Features

- **Dynamic skill discovery** - Automatically finds skills from project, user, and plugin directories - **Context injection** - Loads skill content directly into the conversation context - **Compaction resilient** - Skills survive context compaction in long sessions - **Claude Code compatible** - Works with existing Claude Code skills and plugins - **Optional Superpowers integration** - Drop-in support for the [Superpowers](https://github.com/obra/superpowers) workflow

## Requirements

- [OpenCode](https://opencode.ai/) v1.0.110 or later

## Installation

If you only need standard skill loading, prefer OpenCode's built-in skills support. Install this plugin only if you need one of its additional behaviors.

Add to your OpenCode config (`~/.config/opencode/opencode.json`):

```json { "plugin": ["opencode-agent-skills"] } ```

Restart OpenCode and you're ready to go.

Optionally, pin to a specific version for stability:

```json { "plugin": ["opencode-agent-skills@0.7.0"] } ```

OpenCode fetches unpinned plugins from npm on each startup; pinned versions are cached and require a manual version bump to update.

### Local Development

If you want to customize or contribute:

```bash git clone https://github.com/joshuadavidthomas/opencode-agent-skills ~/.config/opencode/opencode-agent-skills mkdir -p ~/.config/opencode/plugin ln -sf ~/.config/opencode/opencode-agent-skills