openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

4|1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/jankneumann/agentic-coding-tools --skill openspec-onboard-jankneumann
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-onboard
Source: https://github.com/jankneumann/agentic-coding-tools/tree/main/.agents/skills/openspec-onboard
Command: npx skills add https://github.com/jankneumann/agentic-coding-tools --skill openspec-onboard-jankneumann

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through a complete OpenSpec workflow cycle so they can learn the process by doing real work in their repository, reducing friction when adopting OpenSpec and ensuring artifacts are created and recorded correctly.

Core Features & Use Cases

  • Guided, phase-by-phase onboarding that walks through explore, proposal, specs, design, tasks, implementation, and archive.
  • Repository scanning for small starter tasks, drafting of proposal/spec/design/tasks, and saving artifacts via the openspec CLI.
  • Use case: a new contributor or team lead who wants to complete a small change from idea to archived decision while learning the OpenSpec rhythm.

Quick Start

Ask the assistant to run the OpenSpec onboarding flow and walk me through creating and completing a small change in this repository.

Frequently Asked Questions about openspec-onboard

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

FAQPage Schema
How do I create and archive a change using the OpenSpec workflow?

To create and archive a change using the OpenSpec workflow, you run the onboarding flow to generate proposal.md, design.md, spec files, and tasks.md via the openspec CLI, apply the code changes, and then archive the completed decision.

What is the OpenSpec workflow cycle for software engineering tasks?

The OpenSpec workflow cycle is a phase-by-phase process covering exploration, proposal drafting, writing specs and designs, generating tasks, implementing code, and archiving completed changes to ensure artifacts are recorded correctly in the repository.

Do I need an initialized OpenSpec project to start drafting proposals and specs?

Yes, you need an initialized OpenSpec project with the openspec CLI installed. This Skill requires an active project environment to scan for starter tasks, provide stepwise prompts, and save artifacts like proposal.md and design.md.

How do I generate tasks and design documents from a repository proposal?

You generate tasks and design documents by following the guided onboarding prompts that scan your repository for small starter tasks, draft the proposal and design.md, and save these artifacts using the openspec CLI commands.

Can I use OpenSpec onboarding to teach new contributors the spec-driven workflow?

Yes, OpenSpec onboarding is designed for new contributors and team leads to complete a small change from idea to archived decision while learning the OpenSpec rhythm through hands-on, real code implementation in their repository.