# Updating Openspec Instructions

> Updates OpenSpec instruction files in a project. Use when OpenSpec is already initialized but instructions need refreshing or the CLI was updated.

- Skill: `yu-iskw/updating-openspec-instructions` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yu-iskw/updating-openspec-instructions`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yu-iskw/updating-openspec-instructions/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yu-iskw (https://skillmd.com/u/yu-iskw)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yu-iskw/updating-openspec-instructions

---


# Updating OpenSpec Instructions

## Purpose

Ensures that the AI agent's instruction files (e.g., `.cursorrules`, `claude.json`) are up-to-date with the latest OpenSpec standards and project configuration.

## 1. Safety & Verification

1.  **Check Help**: Run `npx @fission-ai/openspec@latest update --help`.
2.  **Verify Initialization**: Ensure OpenSpec has already been initialized in the project (check for `openspec/` directory).

## 2. Common Workflows

### Workflow: Refresh Instructions

1.  Run `npx @fission-ai/openspec@latest update`.
2.  Use `--force` to overwrite existing instructions even if they appear up-to-date.

## 3. Error Handling

- If the command fails because OpenSpec is not initialized: Run `initializing-openspec` first.

## 4. Examples

### Example: Force Update Instructions

**Command**: `npx @fission-ai/openspec@latest update --force`
**Expected Output**: Updated instruction files in the project root or `.cursor/` directory.