opencode-plugin-openspec

Name: opencode-plugin-openspec
Author: Octane0411

Verified

An OpenCode plugin that integrates OpenSpec, adding a dedicated 'openspec-plan' mode for creating and editing spec files.

133stars

9forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/Octane0411/opencode-plugin-openspec

Getting Started

Guides for using ai agents skills like opencode-plugin-openspec.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T16:35:02.937Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is opencode-plugin-openspec?

opencode-plugin-openspec is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Octane0411. An OpenCode plugin that integrates OpenSpec, adding a dedicated 'openspec-plan' mode for creating and editing spec files. It has 133 GitHub stars.

Is opencode-plugin-openspec safe to use?

Yes. opencode-plugin-openspec passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install opencode-plugin-openspec?

Clone the repository with "git clone https://github.com/Octane0411/opencode-plugin-openspec" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is opencode-plugin-openspec written in?

opencode-plugin-openspec is primarily written in TypeScript. It is open-source under Octane0411 on GitHub, so you can review or fork the full source.

Are there alternatives to opencode-plugin-openspec?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh opencode-plugin-openspec against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

claude-ipc-mcp opencrust

opencode-plugin-openspec

An OpenCode plugin that integrates OpenSpec, providing a dedicated agent for planning and specifying software architecture.

Motivation

This plugin addresses the need for a dedicated planning mode in OpenCode.

The Problem: When using OpenCode's standard "Build mode" to create or modify OpenSpec planning documents, AI agents often attempt to start implementing code changes immediately, before the planning phase is complete. This can lead to premature coding and a lack of focus on the architectural design.

The Solution: opencode-plugin-openspec introduces a specialized OpenSpec Architect agent. This agent is configured to:

Allow creating and editing OpenSpec documents (e.g., project.md, specs/**).
Prevent modifications to the implementation code.
Focus entirely on planning and specification, ensuring a clear separation between design and implementation.

Features

Auto-Detection: Automatically detects if the current workspace is an OpenSpec project.
New Agent: openspec-plan: A dedicated agent mode for creating and editing OpenSpec files.
Smart Permissions: Automatically grants write permissions for:
- project.md
- AGENTS.md
- openspec/**
- specs/**
Read-Only Safety: Keeps the rest of the codebase read-only when using the openspec-plan agent, ensuring the implementation details are not accidentally modified during the planning phase.

Installation

For Humans

Option 1: Let your agent do it (Recommended)

Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):

Install opencode-plugin-openspec by following the instructions here:
https://raw.githubusercontent.com/Octane0411/opencode-plugin-openspec/main/README.md

Option 2: Manual Installation

Add the plugin package name to your opencode.json configuration file (usually located at ~/.config/opencode/opencode.json or .opencode/opencode.json):

{
  "plugin": [
    "opencode-plugin-openspec"
  ]
}

OpenCode will automatically download and install the plugin the next time it runs.

For LLM Agents

If you are an AI agent tasked with setting up this plugin, follow these steps:

IMPORTANT: Do NOT run npm install or any terminal commands. You only need to edit the configuration file.

Locate Configuration: Find the user's OpenCode configuration file. It is typically at ~/.config/opencode/opencode.json or .opencode/opencode.json in the workspace root.
Read Configuration: Read the content of the configuration file.
Update Configuration: Add "opencode-plugin-openspec" to the plugin array. If the plugin array does not exist, create it.
```
{
  "plugin": [
    "opencode-plugin-openspec"
  ]
}
```
Verify: Inform the user that the plugin has been added and will be installed on the next OpenCode run.

Note: You do not need to run npm install or download the package manually. OpenCode will automatically fetch the plugin based on the configuration.

Usage

Open an OpenSpec project in OpenCode.
The plugin will automatically detect the project structure.
Switch to the OpenSpec Architect agent (colored #FF6B6B) in the agent selector.
Start planning your architecture! The agent will have access to modify your spec files while keeping your code safe.

Development

Clone the repository:

git clone https://github.com/Octane0411/opencode-plugin-openspec.git
cd opencode-plugin-openspec

Install dependencies:
```
bun install
```
Build the plugin:
```
bun run build
```
Run watch mode for development:
```
bun run watch
```

License

MIT