skills.rest
jeffbalagosa
jeffbalagosaCOMMUNITY
Explore all skills by this author →
GitHub

openspec-onboard

Guides users through the complete OpenSpec workflow from exploration to archiving with templates and prompts.

1|Updated May 22, 2022
Search Tags:#workflow#onboarding#openspec#proposal#specs#change-cycle
One-click install
npx skills add https://github.com/jeffbalagosa/pick-or-shuffle --skill openspec-onboard-jeffbalagosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/jeffbalagosa/pick-or-shuffle/tree/main/.gemini/skills/openspec-onboard
Command: npx skills add https://github.com/jeffbalagosa/pick-or-shuffle --skill openspec-onboard-jeffbalagosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Onboarding new users to OpenSpec can be lengthy and confusing. This skill provides a guided, hands-on walkthrough that teaches the complete OpenSpec workflow with narration and real codebase work.

Core Features & Use Cases

  • Guided, phase-by-phase onboarding through a real OpenSpec change lifecycle (preflight, exploration, change creation, proposal, specs, design, tasks, implementation, and archiving).
  • Provides artifact templates and prompts that illustrate how to capture rationale, requirements, and decisions.
  • Safe, learning-focused guidance that keeps tasks small and actionable, with guardrails to prevent scope creep.

Quick Start

Begin the onboarding by creating a new OpenSpec change and following the guided phases from exploration to archive.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
What is the OpenSpec change cycle workflow?▼

The OpenSpec change cycle is a structured process guiding users from exploration to archiving through preflight checks, change creation, proposal drafting, specs, design, tasks, implementation, and archiving artifacts.

How do I start onboarding with OpenSpec in a real codebase?▼

To start OpenSpec onboarding, create a new change and follow guided, phase-by-phase prompts that walk you through artifact templates and safe, learning-focused tasks within your real codebase.

What artifacts do I need to create during the OpenSpec proposal process?▼

During the OpenSpec proposal process, you must create structured artifacts including a proposal, specs, design documents, and tasks to capture rationale, requirements, and decisions throughout the lifecycle.

Can I use guided OpenSpec onboarding to prevent scope creep in my changes?▼

Yes, guided OpenSpec onboarding provides safe prompts and guardrails specifically designed to keep tasks small, focused, and actionable, preventing scope creep during the change cycle.

When do I need to run preflight checks in the OpenSpec workflow?▼

Preflight checks in the OpenSpec workflow run at the beginning of the onboarding lifecycle, ensuring your environment is ready before proceeding to task selection, change creation, and proposal drafting.

What is the best way to archive a completed OpenSpec change?▼

The best way to archive an OpenSpec change is to follow the guided onboarding workflow's final phase, which safely transitions your completed proposal, specs, design, and implementation tasks into an archived state.

Related Skills

Explore More Education & Research Skills→
syifansyifan
5

openspec-onboard

Guide users through the OpenSpec change management workflow with real codebase tasks.

Community
Intermediate
CodenburgCodenburg

sdd-onboard

Guide users through the SDD cycle using their actual codebase.

Community
Advanced
CharGrnmnCharGrnmn
1

gpd-complete-milestone

Mark completed research milestones, archive documents, and tag them in version control.

Community
Advanced
undertextundertext

spdd-reverse

Extract requirements, entities, and structure from codebases into REASONS Canvas prompts.

Community
Advanced