openspec-onboard

Guide users through an OpenSpec workflow cycle on real codebase tasks.

Updated Feb 12, 2021
One-click install
npx skills add https://github.com/echowaves/WiSaw.cdk --skill openspec-onboard-echowaves
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/echowaves/WiSaw.cdk/tree/main/.roo/skills/openspec-onboard
Command: npx skills add https://github.com/echowaves/WiSaw.cdk --skill openspec-onboard-echowaves

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you learn OpenSpec by guiding you through an end-to-end workflow cycle on real tasks, so you quickly understand how to move from exploration to implementation and archiving.

Core Features & Use Cases

  • Guided end-to-end workflow: Runs you through the full cycle from task selection through proposal, specs, design, tasks, implementation, and archiving.
  • Real codebase analysis: Encourages scanning for TODO/FIXME items, missing validation, risky error handling, tests gaps, and other pragmatic quick wins.
  • Scope guardrails for learning: Helps keep your first run focused on small, finishable changes while still letting you override if needed.
  • Operational command guidance: Provides the OpenSpec commands and checkpoints needed to create and manage the change artifacts.

Quick Start

Start onboarding by running: /opsx:onboard.

Frequently Asked Questions about openspec-onboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I complete an OpenSpec workflow cycle for a codebase change?

You can learn OpenSpec by running a guided end-to-end onboarding cycle on real tasks, moving from codebase exploration through proposal, specs, design, tasks, implementation, and archiving.

What is the best way to plan a codebase task using OpenSpec?

Task planning in OpenSpec involves selecting a real codebase task, creating a change proposal, drafting specs, breaking the work into actionable tasks, and maintaining scope guardrails to keep changes small and finishable.

Can I use OpenSpec onboarding to analyze existing code for quick wins?

Yes, OpenSpec onboarding encourages real codebase analysis by scanning for TODO and FIXME items, missing validation, risky error handling, and test gaps to find pragmatic quick wins for your workflow.

Does OpenSpec onboarding restrict the size of my first implementation task?

OpenSpec onboarding applies scope guardrails for learning to keep your first run focused on small, finishable changes, while still letting you override these limits if you need to tackle a larger task.

How to start the OpenSpec workflow onboarding process?

Start the OpenSpec workflow onboarding process by running the /opsx:onboard command, which provides operational command guidance and checkpoints to manage your change artifacts end-to-end.