openspec-onboard

Guide OpenSpec onboarding by creating change containers and generating artifacts.

113|19|Updated Apr 8, 2025
One-click install
npx skills add https://github.com/goern/forgejo-mcp --skill openspec-onboard-goern
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/goern/forgejo-mcp/tree/main/.claude/skills/openspec-onboard
Command: npx skills add https://github.com/goern/forgejo-mcp --skill openspec-onboard-goern

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a guided, hands-on onboarding experience for OpenSpec, enabling users to learn by doing a complete workflow cycle inside their codebase while an assistant explains each step.

Core Features & Use Cases

  • Step-by-step onboarding across preflight, task selection, proposal, specs, design, tasks, and archive.
  • Real-work in a live codebase with narrations and explanations.
  • Reusable workflow to onboard new contributors to OpenSpec in future projects.

Quick Start

Install the OpenSpec CLI and run the onboarding flow against your project. Use the provided steps to initialize a change and generate proposal, specs, design, and tasks.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I learn OpenSpec workflow by doing it in my codebase?

You can learn the OpenSpec workflow by using a guided onboarding process that creates a change container in your repository and walks you through each phase, from preflight to archival, while generating actual artifacts like proposals, specs, design, and tasks.

What is the OpenSpec change management process for onboarding new contributors?

The OpenSpec change management onboarding process is a step-by-step workflow that takes new contributors through preflight, task selection, proposal creation, specification, design, task generation, and archiving within a live codebase to ensure hands-on learning.

Do I need the OpenSpec CLI installed to run onboarding tasks in my repository?

Yes, you need the OpenSpec CLI installed and an accessible code repository to perform the onboarding tasks, as the process requires scaffolding a change container and generating artifact files directly within your project.

What artifacts are generated during a guided OpenSpec workflow?

During a guided OpenSpec workflow, the artifacts generated include proposal files, specifications, design documents, and task lists, all created within a change container to demonstrate full cycle change management in your codebase.

Can I use OpenSpec onboarding to teach workflow steps in future projects?

Yes, you can use OpenSpec onboarding to teach workflow steps in future projects because it provides a reusable, narrated onboarding experience that demonstrates exploration, artifact generation, and documentation across preflight to archival phases.

What are the limitations of using guided onboarding for OpenSpec change management?

A limitation of guided OpenSpec onboarding is that it strictly requires the OpenSpec CLI and a live, accessible code repository to function, meaning it cannot be used for standalone theoretical practice without an active codebase environment.