openspec-explore

Explores ideas, investigates codebases, and clarifies requirements before creating OpenSpec change proposals.

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/33may/robotics --skill openspec-explore-33may
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/openspec-explore
Command: npx skills add https://github.com/33may/robotics --skill openspec-explore-33may

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 dedicated explore mode where the AI acts as a thinking partner—investigating the codebase, visualizing architecture, and clarifying requirements—without writing any implementation code. ## Core Features & Use Cases - Exploration-Only Stance: Reads files, searches code, and investigates the codebase while strictly refusing to implement features, keeping thinking separate from coding. - Visual Thinking: Produces ASCII diagrams, state machines, data flows, and comparison tables to clarify architecture and tradeoffs. - OpenSpec Integration: Checks active changes via openspec list --json, reads existing change artifacts, and offers to capture decisions into proposals, designs, specs, or tasks. - Use Case: A developer unsure whether to use SQLite or Postgres for a CLI tool enters explore mode, gets a constraint-driven comparison grounded in their actual context, then captures the decision in design.md before starting a change proposal. ## Quick Start Ask the AI to enter explore mode and think through your idea or problem, for example by saying: explore whether we should add real-time collaboration to our editor before I write any code.

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 software idea before writing code?

Enter explore mode and describe your idea or problem in natural language. The AI investigates your codebase, draws ASCII diagrams of architecture and tradeoffs, and asks clarifying questions, all without writing any implementation code.

What is OpenSpec explore mode used for?

OpenSpec explore mode is a thinking partnership for clarifying requirements, comparing options, and investigating code before or during a change. It can capture decisions into OpenSpec artifacts like proposals, designs, and specs when you ask.

Can explore mode write or modify application code?

No, explore mode never writes application code or implements features. It may only read files, search code, and create OpenSpec artifacts such as proposals and specs when explicitly requested.

Does openspec-explore require the openspec CLI?

Yes, the Skill requires the openspec CLI to be installed. It runs commands like openspec list --json and openspec status --change to detect active changes and read existing artifact paths for context.

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

Exit explore mode when your thinking has crystallized into a concrete approach and you are ready to implement. The AI will offer to create a change proposal when insights solidify, but the decision to formalize is always yours.