openspec-explore

Explore repository ideas and clarify requirements without writing implementation code.

Updated Dec 25, 2025
One-click install
npx skills add https://github.com/wtg42/tty-clock-timer --skill openspec-explore-wtg42
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/wtg42/tty-clock-timer/tree/main/.opencode/skills/openspec-explore
Command: npx skills add https://github.com/wtg42/tty-clock-timer --skill openspec-explore-wtg42

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a guided, conversational exploration mode to help teams and individuals think through ideas, investigate a codebase, and clarify requirements before any implementation begins. It reduces premature design decisions, surfaces hidden assumptions, and helps articulate questions and tradeoffs needed to scope a change.

Core Features & Use Cases

  • Guided discovery: Ask probing questions, reframe problems, and surface alternative approaches during early-stage planning.
  • Codebase investigation: Read repository files, map architecture, and identify integration points or technical debt relevant to a proposal.
  • Artifact capture without implementation: Help produce OpenSpec artifacts (proposals, designs, specs) while explicitly avoiding writing implementation code or changes.
  • Visualization and risk surfacing: Draw ASCII diagrams, outline state flows, and list unknowns, risks, and suggested spikes.

Quick Start

Ask openspec-explore to review the timer architecture and list the top open design questions and risks.

Frequently Asked Questions about openspec-explore

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clarify requirements and explore design ideas before writing implementation code?

Conduct conversational requirements discovery to reframe problems, surface hidden assumptions, and articulate tradeoffs. This guided exploration reads repository files to help you scope changes and produce design artifacts without committing to premature implementation code.

What is the best way to investigate a codebase during early-stage architecture planning?

Use a conversational thinking partner to map architecture, identify integration points, and highlight technical debt. This codebase investigation approach reads repository files to outline state flows and list unknowns, capturing proposals and specs for early-stage design.

Can I capture design specs and proposals without generating implementation code?

Yes, capturing OpenSpec artifacts like proposals, designs, and specs without implementation code is the core function. The conversational environment explicitly enforces a rule against producing code changes, focusing solely on requirements discovery and planning artifacts.

How do I visualize technical risks and unknowns when scoping a repository change?

Visualize risks and unknowns by drawing ASCII diagrams and outlining state flows during the exploration process. This approach surfaces alternative approaches, lists technical debt relevant to a proposal, and suggests spikes needed to clarify requirements before implementation.

Do I need a specific CLI context to perform conversational requirements discovery?

Yes, you need repository file access and the openspec CLI context to perform conversational requirements discovery. This environment provides the necessary codebase investigation capabilities to analyze ideas, map architecture, and produce OpenSpec artifacts.

When should I avoid using a conversational thinking partner for codebase analysis?

Avoid using this conversational thinking partner when you need actual implementation code or direct file changes. It is strictly designed for early-stage planning, requirements discovery, and producing design artifacts, not for executing or writing implementation code.