openspec-onboard

Guide users through OpenSpec onboarding with codebase analysis and artifact generation.

31|10|Updated Dec 10, 2025

Search Tags:#workflow #onboarding #codebase #OpenSpec #workflows

Ready to run

npx skills add https://github.com/yazelin/ching-tech-os --skill openspec-onboard-yazelin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/yazelin/ching-tech-os/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/yazelin/ching-tech-os --skill openspec-onboard-yazelin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) components.

What problem does it solve?

This Skill addresses the complexity of OpenSpec onboarding by providing a guided, step-by-step workflow with real codebase work.

Core Features & Use Cases

Guided Onboarding: Walks users through a complete OpenSpec workflow cycle with narration.
Real Codebase Work: Allows users to do real work in their codebase while learning.
Task Selection: Scans the codebase for improvement opportunities and suggests tasks.
Workflow Artifacts: Handles creation of proposal, specs, design, and tasks artifacts.
Implementation: Provides a structured approach to implementing tasks.
Archiving: Guides users in archiving completed changes for project history.

Quick Start

Run /opsx:new to start your OpenSpec onboarding journey.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema

How do I get started with OpenSpec for an existing codebase?▼

OpenSpec onboarding is streamlined by running the `/opsx:new` command, which initiates a guided workflow cycle. This process walks users through real codebase analysis, change container creation, artifact generation, and task implementation.

What is the OpenSpec workflow cycle for software engineering?▼

The OpenSpec workflow cycle is a structured process for codebase modification. It involves scanning for improvement opportunities, creating change containers, generating proposal and design artifacts, implementing tasks, and archiving completed changes for project history.

Do I need the OpenSpec CLI installed to use the onboarding workflow?▼

Yes, the OpenSpec CLI is a required dependency for this onboarding workflow. The guided process involves real codebase work and relies on the CLI to handle artifact generation, task implementation, and project archiving.

How does OpenSpec identify tasks during codebase onboarding?▼

OpenSpec identifies tasks by scanning your codebase for improvement opportunities. During the onboarding workflow, it suggests actionable tasks and guides you through creating the necessary proposal, specs, and design artifacts to implement them.

Can I do real codebase work while learning the OpenSpec workflow?▼

Yes, the onboarding experience allows you to do real work in your codebase while learning. It provides a step-by-step guided workflow with narration, ensuring you complete actual implementation tasks rather than just running a simulation.

What's the best way to archive completed changes in OpenSpec?▼

The best way to archive completed changes is to follow the guided onboarding workflow's archiving step. This final stage of the cycle ensures your finished implementation and generated artifacts are properly stored in your project history.