Openspec Propose

Use when adding features, changing behavior, or modifying architecture. Creates change proposal with specs and tasks. ALWAYS ask for approval before proceeding to implementation. Do NOT use for bug fixes or trivial changes.

8 stars 3 forksProductivity & Notes Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Freddy-CHEN-ux/00_claude_skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Freddy-CHEN-ux/00_claude_skills --skill openspec-propose
Manual install
git clone --depth 1 https://github.com/Freddy-CHEN-ux/00_claude_skills.git /tmp/00_claude_skills
mkdir -p ~/.claude/skills
cp -r /tmp/00_claude_skills/skills/openspec-propose ~/.claude/skills/openspec-propose

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# OpenSpec Propose

Create change proposals for new features or behavioral changes.

> **Announce:** "I'm using openspec-propose to create a change proposal for approval."

## Iron Law

```
NO IMPLEMENTATION WITHOUT APPROVED PROPOSAL
```

Do NOT write implementation code during this phase. Only create:
- `proposal.md`
- `tasks.md`
- `design.md` (if complex)
- Spec deltas

## Process

### Phase 1: Gather Context

1. Read `openspec/project.md` for conventions
2. Run `openspec list --specs` to see current capabilities
3. Run `openspec list` to check for conflicts
4. Search codebase for related code: `rg [keyword]`

### Phase 2: Choose Change ID

Format: `verb-noun` in kebab-case

Examples:
- `add-leaderboard`
- `update-scoring-algorithm`
- `refactor-game-state`

Verify uniqueness against `openspec list`.

### Phase 3: Create Proposal

Create `openspec/changes/[id]/proposal.md`:

```markdown
# Change: [Brief description]

## Why

[1-2 sentences: What problem does this solve?]

## What Changes

- [Change 1]
- [Change 2]
- **BREAKING**: [If any breaking changes]

## Impact

- Affected specs: [list]
- Affected code: [key files/directories]
```

### Phase 4: Create Spec Deltas

For each affected capability, create `openspec/changes/[id]/specs/[capability]/spec.md`:
Read the full skill on GitHub

Details

Skill name
openspec-propose
Path
skills/openspec-propose/SKILL.md
Repo updated
10 January 2026

FAQ

What does the Openspec Propose skill do?

Use when adding features, changing behavior, or modifying architecture. Creates change proposal with specs and tasks. ALWAYS ask for approval before proceeding to implementation. Do NOT use for bug fixes or trivial changes.

How do I install the Openspec Propose skill?

Claude Code plugin: /plugin marketplace add Freddy-CHEN-ux/00_claude_skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Openspec Propose popular?

It lives in Freddy-CHEN-ux/00_claude_skills, which has 8 GitHub stars and 3 forks.

Related skills

Add Integration

8

Freddy-CHEN-ux/00_claude_skills

Build a new API integration for Nexus. Load when user mentions "add integration", "new integration", "integrate with", "connect to [service]", or "build [service] integration". Interactive workflow that discovers API endpoints, plans the integration, and creates a project for implementation.

Software Development

AI Agents

8

Freddy-CHEN-ux/00_claude_skills

Production-grade AI agent patterns with MCP integration, agentic RAG, handoff orchestration, multi-layer guardrails, and observability (modern best practices)

AI, LLMs & Agents

AI LLM

8

Freddy-CHEN-ux/00_claude_skills

Production LLM engineering skill. Covers strategy selection (prompting vs RAG vs fine-tuning), dataset design, PEFT/LoRA, evaluation workflows, deployment handoff to inference serving, and lifecycle operations with cost/safety controls.

AI, LLMs & Agents

Setup Memory

8

Freddy-CHEN-ux/00_claude_skills

Configure Nexus memory with your role, goals, and preferences. Load when user wants to personalize the system or teach Nexus about themselves. Keywords: setup memory, personalize, configure, my goals, my role, about me, preferences. 8 min.

Productivity & Notes

Openspec Apply

8

Freddy-CHEN-ux/00_claude_skills

Use when implementing an APPROVED OpenSpec change. Read tasks.md and follow EXACTLY. Do not deviate, add features, or skip tasks. Use with test-tdd for each code task.

Productivity & Notes

Setup Workspace

8

Freddy-CHEN-ux/00_claude_skills

Organize your 04-workspace/ folder structure. Load when user mentions: setup workspace, organize folders, folder structure, configure workspace, my files, file organization, where to put files, workspace setup, directories, storage. 5-8 min.

Productivity & Notes

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.