openspec-explore

Explores ideas and clarifies requirements through OpenSpec change artifacts and codebase investigation.

1|Updated Aug 21, 2023
One-click install
npx skills add https://github.com/jmuchovej/homelab --skill openspec-explore-jmuchovej
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/jmuchovej/homelab/tree/main/.agents/skills/openspec-explore
Command: npx skills add https://github.com/jmuchovej/homelab --skill openspec-explore-jmuchovej

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into implementation before fully understanding a problem, leading to rework and misaligned requirements. This Skill provides a structured thinking partner that investigates the codebase, visualizes options, and captures decisions as OpenSpec change artifacts without writing implementation code. ## Core Features & Use Cases - Guided Discovery: Asks focused questions, challenges assumptions, and surfaces risks while grounding discussion in the actual codebase and existing OpenSpec specs. - ASCII Visualization: Draws architecture diagrams, state machines, and comparison tables in plain ASCII to clarify complex design spaces. - Change Capture: Scaffolds new changes with openspec new change and creates proposals, designs, specs, and task artifacts following CLI-provided instructions and dependency order. - Use Case: A developer considering real-time collaboration uses explore mode to map the design space, compare CRDT versus presence-based approaches, and then capture the agreed decisions into a new OpenSpec change proposal. ## Quick Start Ask the assistant to enter explore mode and think through your feature idea or problem before creating an OpenSpec change proposal.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I explore a feature idea before writing code?

Enter explore mode and describe your idea or problem. The assistant investigates the codebase, asks focused questions, draws ASCII diagrams, and compares options. When decisions crystallize, it can capture them as an OpenSpec change proposal with your confirmation.

How do I create an OpenSpec change proposal from a discussion?

Confirm the scope when asked, then the assistant runs openspec new change to scaffold the change, checks status, and follows CLI instructions to create requested artifacts like proposal.md, design.md, and specs in dependency order.

Can explore mode write code or implement features?

No. Explore mode is strictly for thinking and never writes implementation code or edits workflow configuration. It may only create or update OpenSpec change artifacts such as proposals, designs, and specs within a scope you explicitly confirm.

Does openspec-explore require the openspec CLI installed?

Yes. The Skill depends on the openspec CLI for commands like list, show, status, instructions, and new change. Without the CLI, it cannot read spec inventories, scaffold changes, or validate artifact status.

What is a store in OpenSpec and when do I need one?

A store is a standalone OpenSpec repository registered on your machine. If your work lives in one, the assistant discovers store ids with openspec store list and passes --store <id> to commands that read or write specs and changes.