openspec-explore

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

Updated Jan 5, 2025
One-click install
npx skills add https://github.com/ValorVie/settingZsh --skill openspec-explore-valorvie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/ValorVie/settingZsh/tree/main/.gemini/skills/openspec-explore
Command: npx skills add https://github.com/ValorVie/settingZsh --skill openspec-explore-valorvie

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 mode that helps you explore ideas, investigate the codebase, and crystallize requirements before committing to a change. ## Core Features & Use Cases - Exploration Stance: Acts as a curious thinking partner that asks clarifying questions, challenges assumptions, and surfaces risks without following a rigid script. - Codebase Investigation: Reads files, maps architecture, finds integration points, and grounds discussions in the actual code rather than theory. - ASCII Visualization: Liberally uses diagrams, state machines, comparison tables, and architecture sketches to clarify complex thinking. - OpenSpec Integration: Detects active changes via the openspec CLI, reads existing proposals and designs, and offers to capture decisions into specs, design.md, tasks.md, or proposal.md. - Use Case: Before building a real-time collaboration feature, use explore mode to map the collaboration spectrum (presence, cursors, CRDT sync), compare tradeoffs, and then formalize the decision into an OpenSpec change proposal. ## Quick Start Ask the assistant to enter explore mode and think through your 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 in natural language. The assistant acts as a thinking partner, asking clarifying questions, drawing ASCII diagrams, and investigating the codebase to help the problem's shape emerge before you commit to implementation.

What is OpenSpec explore mode used for?▼

Explore mode is a thinking stance for investigating problems and clarifying requirements, not a fixed workflow. It can read code, compare options, and create OpenSpec artifacts like proposals and specs, but it never writes application code.

Can explore mode implement features or write code?▼

No. Explore mode explicitly forbids writing code or implementing features. If you ask for implementation, it will remind you to exit explore mode and create a change proposal first. It may only create OpenSpec artifacts such as proposals, designs, and specs.

Does openspec-explore require the openspec CLI?▼

Yes, the skill requires the openspec CLI to be installed. It runs commands like openspec list --json to detect active changes and reads artifacts under openspec/changes/ to ground the discussion in existing context.

How are exploration decisions captured in OpenSpec?▼

When insights crystallize, the assistant offers to record them in the appropriate artifact: new requirements go to specs, design decisions to design.md, scope changes to proposal.md, and new work to tasks.md. It offers rather than auto-capturing, so you stay in control.