openspec-onboard

Name: openspec-onboard
Availability: InStock
Author: Goodway

Guides users through a complete OpenSpec workflow cycle from task selection to archiving.

Updated May 5, 2026

Search Tags:#workflow #onboarding #implementation planning #specification #change management #openspec #codebase refactoring

Ready to run

npx skills add https://github.com/agoodway/goodday --skill openspec-onboard-agoodway

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/agoodway/goodday/tree/main/.opencode/skills/openspec-onboard
Command: npx skills add https://github.com/agoodway/goodday --skill openspec-onboard-agoodway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces uncertainty about how to run a full OpenSpec cycle by guiding you through a complete workflow end-to-end, including real codebase work.

Core Features & Use Cases

Preflight readiness checks: Verifies the OpenSpec CLI is installed and stops early if it is not.
Guided task selection: Scans for quick wins such as TODO/FIXME items, weak error handling, missing tests, type issues, debug artifacts, and missing validation, then proposes concrete starter tasks.
End-to-end change lifecycle: Walks you through Explore, Create Change, Proposal, Specs, Design, Tasks, Apply, and Archive, using real artifacts inside openspec/changes.
Scope guardrails: Helps keep your first run-through small enough to finish the entire cycle without getting stuck.

Quick Start

Run the guided onboarding to walkthrough a complete change cycle for a small real task found in your codebase, then approve each phase as you go.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema

How do I complete a full OpenSpec workflow cycle for the first time?▼

An OpenSpec workflow cycle is completed by progressing sequentially through Explore, Create Change, Proposal, Specs, Design, Tasks, Apply, and Archive phases. This guided onboarding walks you through each step using real codebase tasks and artifacts stored within the openspec/changes directory.

What is the OpenSpec onboarding process for teams adopting specification workflows?▼

The OpenSpec onboarding process guides teams through a complete change management cycle, from selecting a real codebase task to archiving the finished change. It includes preflight checks, deterministic phase transitions, and scope guardrails to ensure the first implementation planning cycle finishes successfully.

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

Yes, the OpenSpec CLI must be installed before starting. The onboarding process begins with a preflight readiness check that verifies the CLI is present and stops early if it is missing, ensuring your environment supports deterministic workflow phase transitions.

How do I select a task for my first OpenSpec change management cycle?▼

Task selection is guided by scanning your codebase for quick wins such as TODO/FIXME items, weak error handling, missing tests, type issues, debug artifacts, and missing validation. It proposes concrete starter tasks with scope guardrails to keep the work small enough to finish.

What are the limitations when running an OpenSpec workflow for codebase refactoring?▼

The primary limitation is scope; the workflow applies guardrails to keep your first run-through small enough to complete the entire cycle without getting stuck. It focuses on deterministic phase transitions and requires real artifacts inside openspec/changes.