Agent skill

Openspec Feature Workflow

by SYZ-Coder in SYZ-Coder/superpowers-openspec-team-skills

A skill your agent uses when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding.

MITAuto-check passed

Install Openspec Feature Workflow

skills CLI
$ npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill openspec-feature-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install SYZ-Coder/superpowers-openspec-team-skills openspec-feature-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/SYZ-Coder/superpowers-openspec-team-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/team-skills/openspec-feature-workflow .claude/skills/openspec-feature-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openspec-feature-workflow
GitHub stars
196
Token cost
~462 tokens
SKILL.md length
188 words
Files
5
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding.

  • Works in 6 steps: Derive or confirm a kebab-case change… → Create the change under… → Run openspec status --change "" --json… → …
  • A feature needs an OpenSpec change with proposal
  • SKILL.md covers Overview, Workflow, When to Use and Artifact Expectations, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Openspec Feature Workflow is an agent skill from SYZ-Coder/superpowers-openspec-team-skills. Use when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding. Trigger when the repo policy requires OpenSpec for non-trivial features, when the user asks for proposal/design/tasks first, or when behavior changes need durable change artifacts.

Its SKILL.md is about 460 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `README.md`, `agents/openai.yaml` and `readme_cn.md`).

The repository describes itself as: 一套带有记忆和自学习的harness-team-skills企业级编程技能组合库 针对superpowers+openspec 进行按需组合使用,适用于个人与团队协作进行AI编程. The licence is MIT.

When your agent uses it

  • A feature needs an OpenSpec change with proposal
  • Tasks completed before coding
  • The repo policy requires OpenSpec for non-trivial features
  • The user asks for proposal/design/tasks first

Example prompts

  • “/openspec-feature-workflow”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Derive or confirm a kebab-case change name.
  2. Create the change under openspec/changes//.
  3. Run openspec status --change "" --json to inspect artifact order.
  4. Read openspec instructions --change "" --json before writing each artifact.
  5. Complete artifacts in dependency order
  6. Re-check status until all apply-required artifacts are done before implementation starts.

What it can do on your machine

Read from SKILL.md and the folder at commit 1426ddc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openspec Feature Workflow loads about 462 tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 188 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~462

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from SYZ-Coder/superpowers-openspec-team-skills at commit 1426ddc, republished under its MIT licence (© SYZ-Coder). 188 words, ~462 tokens.

Download SKILL.mdSave it as .claude/skills/openspec-feature-workflow/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
openspec-feature-workflow
description
Use when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding. Trigger when the repo policy requires OpenSpec for non-trivial features, when the user asks for proposal/design/tasks first, or when behavior changes need durable change artifacts.

OpenSpec Feature Workflow

Overview

Use this skill for the OpenSpec half of feature delivery. It creates and completes the change artifacts needed before implementation.

This is an explicit opt-in workflow. Do not use it by default. Only use it when the user explicitly asks for this workflow, names this skill, or a repository policy explicitly requires it.

Workflow

  1. Derive or confirm a kebab-case change name.
  2. Create the change under openspec/changes/<change-name>/.
  3. Run openspec status --change "<change-name>" --json to inspect artifact order.
  4. Read openspec instructions <artifact> --change "<change-name>" --json before writing each artifact.
  5. Complete artifacts in dependency order:
    • proposal.md
    • design.md
    • specs/.../spec.md
    • tasks.md
  6. Re-check status until all apply-required artifacts are done before implementation starts.

When to Use

  • The user explicitly asks for proposal/design/tasks before coding
  • The user explicitly names $openspec-feature-workflow
  • AGENTS.md or team policy explicitly requires this workflow

Artifact Expectations

  • proposal.md: why and what changed
  • design.md: technical approach and trade-offs
  • specs/.../spec.md: normative requirements and scenarios
  • tasks.md: executable implementation checklist

Guardrails

  • Do not skip dependency order from openspec status
  • Do not copy instruction metadata into artifact files
  • Do not start coding until required artifacts are ready

© SYZ-Coder, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in team-skills/openspec-feature-workflow of SYZ-Coder/superpowers-openspec-team-skills.

  • SKILL.md
  • README.md
  • agents/openai.yaml
  • readme_cn.md
  • workflow.yaml

Open the folder on GitHubat commit 1426ddc

Compare with similar skills

Openspec Feature Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openspec Feature Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openspec Feature Workflow this skillSYZ-Coder/superpowers-openspec-team-skills196—~462Automated safety check: PassMIT
Issue Spec Proposehigress-group/higress9.5k—~1.1kAutomated safety check: PassMIT
Spec Writergarrytan/gstack136k—~14kAutomated safety check: NotesMIT
Openspec Sync Specstsedio/tsed3.1k6 repos~3.9kAutomated safety check: PassMIT
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT
OpenSpec Bulk Change ArchiverFission-AI/OpenSpec71k2 repos~5.6kAutomated safety check: PassMIT

Similar skills

  • Issue Spec Propose

    higress-group/higress

    Create or continue proposal, SPEC, QUESTION, design, and TASK artifacts for an issue-spec change.

    9.5k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Spec Writer

    garrytan/gstack

    Converts a vague idea into a precise, executable spec in five phases, files it as an issue and can start an agent on it in a fresh worktree.

    136k GitHub stars~14k tokensUpdated today
    DevelopmentAuto-check: notes
  • Sync delta specs from an OpenSpec change to main specs. An agent skill from tsedio/tsed.

    3.1k GitHub starsUsed in 6 repos~3.9k tokens
    Auto-check passed
  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes
  • Archives several completed OpenSpec changes in one operation, checking the codebase to resolve spec conflicts rather than archiving blindly.

    71k GitHub starsUsed in 2 repos~5.6k tokens
    DevelopmentAuto-check passed
  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed

More from SYZ-Coder/superpowers-openspec-team-skills

  • Superpowers Openspec Superpowers Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants this workflow, wants Superpowers exploration before OpenSpec artifacts, or is confirming or continuing tasks that this workflow already…

    196 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Openspec Superpowers Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants an OpenSpec-first path that creates proposal, design, specs, and tasks before handing off to Superpowers execution, verification, and optional…

    196 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Superpowers Feature Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when feature work needs the Superpowers stages before or during implementation: brainstorming, design confirmation, implementation planning, worktree setup, test-driven…

    196 GitHub stars~891 tokensUpdated 3 mo ago
    Auto-check passed
  • Superpowers Learning Workflow

    SYZ-Coder/superpowers-openspec-team-skills

    A skill your agent uses when the user explicitly wants to capture lessons from completed work, persist durable project knowledge, or turn repeated patterns into reusable learning notes for future…

    196 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Openspec Feature Workflow

What does Openspec Feature Workflow do?

A skill your agent uses when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding. Openspec Feature Workflow is an agent skill from SYZ-Coder/superpowers-openspec-team-skills. Use when a feature needs an OpenSpec change with proposal, design, specs, and tasks completed before coding.

When should I use Openspec Feature Workflow?

Openspec Feature Workflow fits situations like: A feature needs an OpenSpec change with proposal; tasks completed before coding; the repo policy requires OpenSpec for non-trivial features; the user asks for proposal/design/tasks first.

How do I install Openspec Feature Workflow in Claude Code?

Run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill openspec-feature-workflow -a claude-code`. Or copy the skill folder (team-skills/openspec-feature-workflow in SYZ-Coder/superpowers-openspec-team-skills) into .claude/skills/openspec-feature-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Openspec Feature Workflow in Codex?

Run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill openspec-feature-workflow -a codex`. Or copy the skill folder (team-skills/openspec-feature-workflow in SYZ-Coder/superpowers-openspec-team-skills) into .agents/skills/openspec-feature-workflow in your project. Codex loads it when a task matches its description.

Can I use Openspec Feature Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SYZ-Coder/superpowers-openspec-team-skills --skill openspec-feature-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openspec-feature-workflow, .gemini/skills/openspec-feature-workflow, .github/skills/openspec-feature-workflow and .opencode/skills/openspec-feature-workflow in your project.

What does Openspec Feature Workflow need to run?

SKILL.md names no scripts, command-line tools or credentials: Openspec Feature Workflow is instructions for the agent only.

Does Openspec Feature Workflow access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Openspec Feature Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Openspec Feature Workflow use?

Openspec Feature Workflow is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openspec Feature Workflow use?

About 462 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openspec Feature Workflow?

Skills that share tags, products or a category with Openspec Feature Workflow: Issue Spec Propose (higress-group/higress, 9.5k stars), Spec Writer (garrytan/gstack, 136k stars), Openspec Sync Specs (tsedio/tsed, 3.1k stars) and Geo Proposal (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openspec Feature Workflow?

SYZ-Coder (a GitHub user) maintains it in SYZ-Coder/superpowers-openspec-team-skills, which has 196 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on June 12, 2026.

Source: SYZ-Coder/superpowers-openspec-team-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.