How do I install the Openspec skill?

Run npx skillmds@latest add makabakaxy/openspec in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openspec safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openspec?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openspec free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openspec?

makabakaxy (@makabakaxy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openspec by makabakaxy — Agent Skill

Name: Openspec
Author: makabakaxy

File contents

openspec (via mcp2cli)

Manage OpenSpec change lifecycle — create, track, validate, and archive spec changes.

Shortcuts

No shortcuts configured. Use: mcp2cli openspec <group> <cmd>

Commands

project

Command	Description	Example	Ref
`mcp2cli openspec project init`	Initialize OpenSpec in your project	`mcp2cli openspec project init`	ref
`mcp2cli openspec project update`	Update OpenSpec instruction files	`mcp2cli openspec project update`	ref
`mcp2cli openspec project refresh-cache`	Force refresh the cached directory listing	`mcp2cli openspec project refresh-cache`	ref

change

Command	Description	Example	Ref
`mcp2cli openspec change create`	Create a new change directory	`mcp2cli openspec change create --name add-dark-mode --description "Add dark mode support"`	ref
`mcp2cli openspec change status`	Display artifact completion status	`mcp2cli openspec change status --change-name add-dark-mode`	ref
`mcp2cli openspec change instructions`	Output enriched instructions for an artifact	`mcp2cli openspec change instructions --artifact design.md --change-name add-dark-mode`	ref
`mcp2cli openspec change archive`	Archive a completed change and update main specs	`mcp2cli openspec change archive --change-name add-dark-mode`	ref

content

Command	Description	Example	Ref
`mcp2cli openspec content list`	List changes or specs	`mcp2cli openspec content listmcp2cli openspec content list --specs`	ref
`mcp2cli openspec content show`	Show details of a change or spec	`mcp2cli openspec content show --item-name add-dark-mode`	ref
`mcp2cli openspec content read-file`	Read any OpenSpec artifact file directly	`mcp2cli openspec content read-file --name add-dark-mode --file-type design.md`	ref
`mcp2cli openspec content validate`	Validate a change proposal or spec	`mcp2cli openspec content validate --item-name add-dark-mode`	ref

Discover Parameters

Append --help to any command for full parameter list:

mcp2cli openspec change create --help

Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.

User Notes

MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in ~/.agents/mcp2cli/servers.yaml - edit there to take effect.

---name: openspecdescription: Manage OpenSpec change lifecycle and project specs via CLI. Use when user needs to create/archive changes, check artifact status, validate proposals, or browse specs.---# openspec (via mcp2cli)Manage OpenSpec change lifecycle — create, track, validate, and archive spec changes.## ShortcutsNo shortcuts configured. Use: `mcp2cli openspec <group> <cmd>`## Commands### project| Command | Description | Example | Ref ||---|---|---|---|| `mcp2cli openspec project init` | Initialize OpenSpec in your project | `mcp2cli openspec project init` | [ref](reference/project.md) || `mcp2cli openspec project update` | Update OpenSpec instruction files | `mcp2cli openspec project update` | [ref](reference/project.md) || `mcp2cli openspec project refresh-cache` | Force refresh the cached directory listing | `mcp2cli openspec project refresh-cache` | [ref](reference/project.md) |### change| Command | Description | Example | Ref ||---|---|---|---|| `mcp2cli openspec change create` | Create a new change directory | `mcp2cli openspec change create --name add-dark-mode --description "Add dark mode support"` | [ref](reference/change.md) || `mcp2cli openspec change status` | Display artifact completion status | `mcp2cli openspec change status --change-name add-dark-mode` | [ref](reference/change.md) || `mcp2cli openspec change instructions` | Output enriched instructions for an artifact | `mcp2cli openspec change instructions --artifact design.md --change-name add-dark-mode` | [ref](reference/change.md) || `mcp2cli openspec change archive` | Archive a completed change and update main specs | `mcp2cli openspec change archive --change-name add-dark-mode` | [ref](reference/change.md) |### content| Command | Description | Example | Ref ||---|---|---|---|| `mcp2cli openspec content list` | List changes or specs | `mcp2cli openspec content list`<br>`mcp2cli openspec content list --specs` | [ref](reference/content.md) || `mcp2cli openspec content show` | Show details of a change or spec | `mcp2cli openspec content show --item-name add-dark-mode` | [ref](reference/content.md) || `mcp2cli openspec content read-file` | Read any OpenSpec artifact file directly | `mcp2cli openspec content read-file --name add-dark-mode --file-type design.md` | [ref](reference/content.md) || `mcp2cli openspec content validate` | Validate a change proposal or spec | `mcp2cli openspec content validate --item-name add-dark-mode` | [ref](reference/content.md) |## Discover ParametersAppend `--help` to any command for full parameter list: mcp2cli openspec change create --help> **Note**: Use Ref links in the Commands table above to view detailed parameter reference and more examples.## User Notes> **MUST READ** [users/skill.md](users/skill.md) for custom workflows and tips.> **Config**: MCP server settings live in `~/.agents/mcp2cli/servers.yaml` - edit there to take effect.

Frequently asked questions

Openspec