mcpField
O
openspec-update

openspec-update

github.com/full-stack-skillsAgent workflows189 installsUpdated 4w ago
Repository

About openspec-update

A skill that runs `openspec update` to regenerate project AI tool configuration files after OpenSpec CLI upgrades or tool-selection changes. It requires an installed CLI and an initialized project.

Key features

  1. 01Regenerates AI tool configuration files
  2. 02Supports forced updates
  3. 03Can target a project directory
  4. 04Lists prerequisites and verification steps

Use cases

  1. 01Refreshing configs after a CLI upgrade
  2. 02Updating missing or outdated skills and commands
  3. 03Applying changed tool selections
  4. 04Regenerating configuration for a specific project

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-update

After installing, type/openspec-updatein Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

OpenSpec Update Skill

Run openspec update to regenerate AI tool configuration files (skills, commands, rules) after upgrading the OpenSpec CLI package. This ensures your project uses the latest slash commands and skill instructions.

When to Use

  • After upgrading the OpenSpec CLI (npm install -g @fission-ai/openspec@latest).
  • When slash commands or skills seem outdated or missing.
  • After changing tool selections and wanting to refresh configs.

Prerequisites

  • OpenSpec CLI installed (see openspec-install).
  • Project initialized with openspec init (see openspec-initial).

Workflow

  1. Upgrade the CLI first (if not already done)

    • npm install -g @fission-ai/openspec@latest (or pnpm/yarn/bun equivalent).

  2. Run update

    • openspec update — regenerates AI tool config files.
    • openspec update --force — force update even when files are up to date.
    • openspec update ./my-project — target a specific directory.

  3. Verify

    • Check that .claude/skills/, .cursor/rules/, or other tool directories have been refreshed.
    • Restart your AI tool to pick up new skills if needed.

Outputs

  • Regenerated tool-specific config files (skills, commands, rules) matching the new CLI version.

Next Steps

  • Continue your workflow with openspec-new, openspec-explore, etc.

Troubleshooting

  • "openspec: command not found": Use openspec-install first.
  • "Project not initialized": Run openspec-initial (openspec init) first.
  • Skills not appearing after update: Restart your AI tool (Claude Code, Cursor, etc.) to reload skills.

References

Comments

Markdown supported