mcpField
O
openspec-onboard

openspec-onboard

github.com/full-stack-skillsAgent workflows188 installsUpdated 4w ago
Repository

About openspec-onboard

openspec-onboard is an interactive tutorial skill for people new to OpenSpec. It walks through a complete change using the user's codebase, from identifying an improvement to archiving it.

Key features

  1. 01Guided OpenSpec workflow tutorial
  2. 02Analysis of the actual codebase
  3. 03Create and implement a real change
  4. 04Verify and archive the change

Use cases

  1. 01Learn OpenSpec hands-on for the first time
  2. 02Practice the workflow before project work

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard

After installing, type/openspec-onboardin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

OpenSpec Onboard Skill

Use /opsx:onboard for a guided, interactive tutorial through the complete OpenSpec workflow. The tutorial uses the user's actual codebase — finding real improvement opportunities, creating a real change, implementing it, and archiving it.

When to Use

  • First-time OpenSpec users who want a hands-on walkthrough.
  • The user says "onboard", "tutorial", "show me how OpenSpec works".
  • Learning the workflow before using it on real work.

Prerequisites

  • OpenSpec initialized in the project (see openspec-initial).

Workflow

  1. Start onboarding

    • Run /opsx:onboard.

  2. Tutorial phases

    1. Welcome and codebase analysis.
    2. Finding an improvement opportunity (small, safe changes).
    3. Creating a change (/opsx:new).
    4. Writing the proposal.
    5. Creating specs.
    6. Writing the design.
    7. Creating tasks.
    8. Implementing tasks (/opsx:apply).
    9. Verifying implementation.
    10. Archiving the change.
    11. Summary and next steps.

  3. Interactive

    • The agent explains each step as it happens.
    • The user chooses which improvement to work on.
    • The change created is real and can be kept or discarded.

Outputs

  • A complete change cycle (from proposal to archive) using the user's actual codebase.
  • The user has first-hand experience with every OPSX command.

Next Steps

  • Start real work with openspec-new or openspec-explore.

Troubleshooting

  • "Commands not recognized": Ensure OpenSpec is initialized (openspec init). See openspec-initial.
  • Takes too long: The tutorial covers the full workflow; expect 15-30 minutes.

References

Comments

Markdown supported