vila-lab avatar

Openspec Propose

If you want to go from idea to structured implementation plan without manually creating a bunch of files, this is the workflow. You describe what you want to build, and it generates a proposal, design doc, and task breakdown in one shot using the openspec CLI's artifact system. It reads the schema dependencies to figure out what order to create things in, uses templates for structure, and stops when everything needed for implementation is ready. The nice part is it handles the busywork of scaffolding a change properly so you can jump straight to reviewing the plan or running apply to start coding. Works best when you have a clear idea of what you're building but don't want to spend time on the setup ceremony.

GitHub stars
457
last updated
May 25, 2026

Install

$ npx -y skills add vila-lab/figmirror --skill openspec-propose --agent claude-code

Installs into .claude/skills of the current project.

Files

Propose a new change - create the change and generate all artifacts in one step.

I'll create a change with artifacts:

  • proposal.md (what & why)
  • design.md (how)
  • tasks.md (implementation steps)

When ready to implement, run /opsx:apply


Input: The user's request should include a change name (kebab-case) OR a description of what they want to build.

Steps

  1. If no clear input provided, ask what they want to build

    Use the AskUserQuestion tool (open-ended, no preset options) to ask:

    "What change do you want to work on? Describe what you want to build or fix."

    From their description, derive a kebab-case name (e.g., "add user authentication" → add-user-auth).

    IMPORTANT: Do NOT proceed without understanding what the user wants to build.

  2. Create the change directory

    openspec new change "<name>"
    

    This creates a scaffolded change at openspec/changes/<name>/ with .openspec.yaml.

Sponsors

Details

Repository
github.com/vila-lab/figmirror
Categories
DevOps & CI/CD, Design & UI/UX
First seen
Jun 11, 2026

More from vila-lab/figmirror

All 5
1YurunChen avatarrepo-docsYurunChen/repo-docs-skillsBuild and maintain a Markdown guide that helps humans understand a repository through real behavior, concepts, and evidence. Use when a user asks to understand 0skills.sh installs
2zhixiangluo avatarcreate-workflowzhixiangluo/10xproductivityDesign and build automation workflows using building blocks — clarify outcomes, decompose by dependencies, reuse prior art, verify each block before chaining, a0skills.sh installs
3zhixiangluo avatartool-connectorzhixiangluo/10xproductivityConnect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowled0skills.sh installs
4sickn33 avatarobservability-monitoring-monitor-setupsickn33/antigravity-awesome-skillsobservability monitoring monitor setup262skills.sh installs
5ahmedasmar avatarmonitoring-observabilityahmedasmar/devops-claude-skillsMonitoring and observability strategy, implementation, and troubleshooting. Use this skill whenever the user mentions monitoring, observability, metrics, logs, 499skills.sh installs
6akin-ozer avatargitlab-ci-validatorakin-ozer/cc-devops-skillsValidate, lint, audit, or fix .gitlab-ci.yml pipelines, stages, and jobs.725skills.sh installs