openspec-explore

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

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-explore-thewoolleyman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/thewoolleyman/personal-knowledge-base/tree/main/.claude/skills/openspec-explore
Command: npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-explore-thewoolleyman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting a new feature or change, developers often jump into implementation before fully understanding the problem space, existing architecture, or tradeoffs. This Skill provides a dedicated explore mode where the AI acts as a thinking partner—investigating the codebase, visualizing options with ASCII diagrams, and clarifying requirements—without writing any implementation code. ## Core Features & Use Cases - Codebase-grounded exploration: Reads files, maps existing architecture, finds integration points, and surfaces hidden complexity relevant to the discussion. - Visual thinking: Uses ASCII diagrams, comparison tables, and state machines to clarify problems, options, and tradeoffs. - OpenSpec integration: Checks active changes via openspec list --json, reads existing proposals/designs/specs, and offers to capture decisions into the right artifacts (proposal.md, design.md, tasks.md, specs). - Use Case: Before adding real-time collaboration to an app, enter explore mode to map the collaboration spectrum (presence, cursors, CRDTs), compare implementation complexity, and crystallize the approach into a change proposal. ## Quick Start Ask the AI to enter explore mode to think through your idea or investigate a problem in the codebase 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 implementing it?▼

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

What is OpenSpec explore mode used for?▼

Explore mode is a thinking stance for clarifying requirements, comparing approaches, and investigating code before or during a change. It can create or update OpenSpec artifacts like proposals and designs, but never implements application code.

Does openspec-explore require the openspec CLI?▼

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

Can explore mode write code or implement features?▼

No. Explore mode explicitly forbids writing application code. It may only read files, search the codebase, and create OpenSpec artifacts such as proposals, designs, and specs when the user asks.

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

Exit explore mode when the problem and approach have crystallized into concrete decisions. The AI will offer to create a change proposal or capture decisions into design.md, tasks.md, or specs when insights solidify.