openspec-explore

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

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill openspec-explore-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/firstsun-dev/skills/tree/main/plugins/spec-driven-development/skills/openspec-explore
Command: npx skills add https://github.com/firstsun-dev/skills --skill openspec-explore-firstsun-dev

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 grounds discussion in the actual codebase using read-only OpenSpec CLI commands. - ASCII Visualization: Draws architecture diagrams, state machines, and comparison tables in plain ASCII to clarify thinking. - Change Capture: Scaffolds new OpenSpec changes via openspec new change and writes proposals, designs, specs, and tasks only after explicit user confirmation. - Use Case: A developer considering real-time collaboration runs explore mode to map the design space, compare CRDT versus presence approaches, and capture the resulting decisions in a change proposal before any code is written. ## Quick Start Ask the agent to enter explore mode and think through whether your planned feature should use SQLite or Postgres 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 with OpenSpec?▼

Invoke explore mode and describe your idea. The agent investigates the codebase, asks focused questions, draws ASCII diagrams, and offers to capture decisions as an OpenSpec change proposal once the thinking crystallizes.

Can openspec-explore write code or implement features?▼

No. Explore mode is strictly for thinking and never implements features. It may create or update OpenSpec change artifacts like proposals and specs only after you explicitly confirm the scope in a separate message.

Does openspec-explore require the openspec CLI?▼

Yes. The skill requires the openspec CLI installed on the machine. It runs commands like openspec list, status, instructions, and new change to read context and scaffold change artifacts.

What is a store in openspec-explore and when do I need one?▼

A store is a standalone OpenSpec repository registered on your machine. If your work lives in one, the skill discovers it with openspec store list and passes --store <id> to commands; otherwise commands act on the nearest local openspec directory.

When should I exit explore mode and create a change proposal?▼

Exit explore mode when you are ready to implement. The skill will offer to scaffold a change with openspec new change once decisions solidify, but implementation itself must happen outside explore mode.