Show OpenSpec Capability
Discover and display the authoritative spec for a capability. This is the entry point for
"see what exists, then read it" — don't list or grep openspec/ blindly before calling
this skill.
Inputs
Optional: a capability name (matching a directory under openspec/specs/) or a keyword to
search for. Omit both to get an index of all capabilities.
Process
- No input given — enumerate every directory under
openspec/specs/. For each, read the## Purposesection (or the first descriptive line) of itsspec.mdand print a one-line index entry:capability-name — <purpose>. Ifopenspec/specs/is empty or missing, report that this repository has no OpenSpec baseline yet — suggest running thess-write-specorss-reverse-specskill. Stop here. - Input matches a capability directory exactly (
openspec/specs/<capability>/) — read and display thatspec.mdin full. - Input is a keyword — search every
openspec/specs/*/spec.md(and, where useful, activeopenspec/changes/*/specs/*/spec.md, excludingarchive/) for the text. Show each match with its capability name and the matching line or excerpt. If more than one capability matches, list them and ask the user which one to display in full. - After displaying a capability, list the 5 most recent archive entries that touched it —
e.g., by finding files matching
openspec/changes/archive/*/specs/<capability>/spec.mdand taking the last 5 in sorted order. For each, show the archive directory name, the first proposal heading if available, and a count of delta sections (ADDED / MODIFIED / REMOVED / RENAMED).
Output
Keep the surrounding commentary concise, but always include the full current spec text. Do not edit any files.