OpenSpec 2.0

OpenSpec now installs skills in .agents/skills/ instead of keeping a separate copy for each coding agent. Tools that don't read this folder, like Claude Code and Kiro, get links to the same skills.

We're also removing the /opsx:* slash commands. Each command already has a matching skill, so there's no need to maintain both.

The OpenSpec workflows themselves haven't changed.

What changed

• Skills are installed in .agents/skills/. Every tool uses the same skills, without duplicate files across folders.
• /opsx:* commands are removed. For example, /opsx:propose becomes /openspec-propose (or $openspec-propose in Codex). You can also just ask your agent for the work.
• openspec update removes files generated by older versions. This includes old slash commands and duplicate skills. Files you've changed in the old locations are kept and listed.
• The delivery setting is no longer needed. Existing configs keep working.
• Amazon Q Developer support is removed because it can't load skills. We recommend Kiro instead.

How to upgrade

Update the OpenSpec CLI, then run this in each project and commit the changes:

openspec update

To preview the changes first, run openspec update --dry-run.

Note: if you edited OpenSpec's skills directly in .agents/skills/, openspec update overwrites those edits. Save them before upgrading.

See the upgrade guide for more details.

Fixes

• openspec completion install no longer edits PowerShell profiles when run from Windows cmd.exe.
• openspec instructions apply no longer cuts off tasks that span several lines in tasks.md.

Full changelog: v1.17.0...v2.0.0