openspec-explore

Explores ideas and investigates codebases as a thinking partner before creating OpenSpec change proposals.

1|1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/phuchoang2603/nixos --skill openspec-explore-phuchoang2603
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/phuchoang2603/nixos/tree/main/home/base/cli/skills/openspec-explore
Command: npx skills add https://github.com/phuchoang2603/nixos --skill openspec-explore-phuchoang2603

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 exploration mode where the AI acts as a thinking partner—investigating the codebase, visualizing options with diagrams, and clarifying requirements—without writing any implementation code. ## Core Features & Use Cases - Explore Mode Stance: Investigates problems, challenges assumptions, and compares options without implementing code, keeping thinking separate from execution. - OpenSpec Integration: Reads project context via the openspec CLI, scaffolds new changes with openspec new change, and captures decisions into proposals, designs, specs, and task artifacts. - Visualization-First Thinking: Uses ASCII diagrams, comparison tables, and architecture sketches to clarify complex problems. - Use Case: A developer considering real-time collaboration features can explore the tradeoffs between presence indicators, shared cursors, and CRDT-based sync, then capture the chosen direction as an OpenSpec change proposal. ## Quick Start Ask the AI to enter explore mode and think through whether Postgres or SQLite fits your CLI tool before creating a 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 in natural language. The AI investigates the codebase, asks clarifying questions, and visualizes options with diagrams, but never writes implementation code during exploration.

What is OpenSpec explore mode used for?▼

Explore mode is a thinking stance for investigating problems, comparing approaches, and clarifying requirements before or during a change. It can capture decisions into OpenSpec artifacts like proposals, designs, and specs when you ask.

Can explore mode create OpenSpec change proposals?▼

Yes, it can scaffold a new change using the openspec new change CLI command and then create requested artifacts following the status and instructions workflow. It never creates change directories manually.

Does openspec-explore require the openspec CLI installed?▼

Yes, the Skill requires the openspec CLI to list changes, read project context, scaffold changes, and write artifacts. Without it, codebase exploration still works but OpenSpec artifact capture does not.

When should I not use explore mode?▼

Avoid explore mode when you already know exactly what to build and want implementation immediately. Explore mode deliberately refuses to write application code, so exit it and create a change proposal first.