spectra-ask

Answer questions by searching and extracting content from openspec documents.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/ycs77/gh-aw-todo-app --skill spectra-ask-ycs77
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-ask
Source: https://github.com/ycs77/gh-aw-todo-app/tree/main/.claude/skills/spectra-ask
Command: npx skills add https://github.com/ycs77/gh-aw-todo-app --skill spectra-ask-ycs77

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures answers are strictly grounded in the project's openspec documents so users avoid hallucinations and get authoritative, traceable information from the codebase documentation.

Core Features & Use Cases

  • Search-first retrieval: Uses embedding-based search to locate relevant files under openspec before answering.
  • Source prioritization: Prefers main specs in openspec/specs and uses openspec/changes archive only for historical context.
  • Error-aware behavior: Detects and reports specific vector search errors and stops when those errors occur.
  • Guardrails & filtering: Enforces read-only access, sensitive-data redaction, and strict scope limits so answers remain safe and on-topic.
  • Use Case: Ask about a design detail or change rationale and receive a concise, document-cited response with referenced file paths.

Quick Start

Ask a question about the project's openspec documents by typing /spectra-ask followed by your query.

Frequently Asked Questions about spectra-ask

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

FAQPage Schema
How do I search openspec documents for specific design decisions?

Search openspec documents for design decisions by using the spectra-ask Skill, which performs embedding-based vector search across openspec/specs and openspec/changes archives to retrieve authoritative, traceable content.

What is the best way to get answers from a project knowledge base without hallucinations?

Getting answers from a project knowledge base without hallucinations requires strict source grounding; the spectra-ask Skill enforces read-only access and source prioritization to extract cited information directly from openspec documents.

Do I need the spectra CLI to query openspec specifications?

Yes, querying openspec specifications with the spectra-ask Skill requires the spectra CLI to handle embedding-based vector search and explicit error checks for vector index states before composing answers.

Can I retrieve change history and rationale from openspec archives?

Yes, you can retrieve change history and rationale from openspec archives; the spectra-ask Skill prioritizes main specs in openspec/specs but uses the openspec/changes archive to provide historical context and document-cited responses.

Why does vector search fail when querying project spec details?

Vector search fails when querying project spec details if there are specific vector index state errors; the spectra-ask Skill detects and reports these explicit errors and stops the search process when those errors occur.

What are the limitations of using vector search for documentation retrieval?

Limitations of using vector search for documentation retrieval include strict scope limits and read-only access; the spectra-ask Skill enforces sensitive-data redaction and reads up to ten files to ensure answers remain safe and on-topic.