skills.rest
igamenovoer
igamenovoerCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

Guide users through an OpenSpec workflow cycle from task selection to archiving.

18|3|Updated Mar 5, 2026
Search Tags:#onboarding#workflow automation#spec writing#software architecture#implementation plan#developer productivity#openspec
One-click install
npx skills add https://github.com/igamenovoer/houmao --skill openspec-onboard-igamenovoer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/igamenovoer/houmao/tree/main/tests/fixtures/plain-agent-def/skills/openspec-onboard
Command: npx skills add https://github.com/igamenovoer/houmao --skill openspec-onboard-igamenovoer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly understand OpenSpec’s workflow by guiding you through a complete, end-to-end change cycle in your actual codebase rather than relying on abstract examples.

Core Features & Use Cases

  • Guided workflow cycle: Walks through Explore → New Change → Proposal → Specs → Design → Tasks → Implementation → Archive with clear narration.
  • Real codebase task selection: Suggests small starter tasks by scanning for TODO/FIXME, risky error handling, missing tests, TypeScript any usage, debug artifacts, and missing validation.
  • Soft scope guardrails: Prevents the first run from becoming too large by steering toward smaller slices, while still allowing user overrides.
  • Operational check for readiness: Verifies OpenSpec is initialized via the OpenSpec CLI before proceeding.

Quick Start

Ask the AI to run the openspec-onboard skill to walk you through your first OpenSpec workflow cycle using a real small task from your repository.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I learn the OpenSpec workflow cycle using my own codebase?▼

You learn the OpenSpec workflow by completing a real end-to-end change cycle in your codebase, moving from task selection through proposal, spec, design, and implementation to archiving.

How do I find a small starter task for spec writing and implementation planning?▼

You can find a starter task by scanning your codebase for TODO/FIXME comments, missing tests, TypeScript any usage, debug artifacts, and missing validation to use for your spec writing cycle.

Do I need the OpenSpec CLI initialized before starting the onboarding workflow?▼

Yes, you need the OpenSpec CLI initialized; the onboarding workflow performs preflight checks to verify readiness before proceeding with change container creation and artifact writing.

What is the expected file structure for OpenSpec proposal and design artifacts?▼

OpenSpec artifacts require writing proposal, spec, design, and task files inside derived-naming change containers to maintain the expected structure and preserve decision history.

How to prevent my first OpenSpec workflow cycle from becoming too large?▼

To prevent an oversized first cycle, the workflow applies soft scope guardrails steering you toward smaller task slices, while still allowing user overrides to expand the implementation scope.

Related Skills

Explore More Education & Research Skills→
wtg42wtg42

openspec-onboard

Guide OpenSpec CLI users through a complete change workflow with proposal, specs, design, tasks, and archive artifacts.

Community
Intermediate
rozxrozx
25

openspec-archive-change

Archive completed OpenSpec changes under a date-based directory.

Community
Advanced
sunnypatneedisunnypatneedi
11

api-design

Design RESTful API endpoints with OpenAPI documentation generation.

Community
Intermediate
cynkracynkra
1

openspec-propose

Generate OpenSpec proposal, design, and task artifacts in one guided flow.

Official
Intermediate