spectra-ask

Query openspec documents with vector search to answer specification-based questions.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/cashwu/Keyify --skill spectra-ask
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spectra-ask
Source: https://github.com/cashwu/Keyify/tree/main/.agents/skills/spectra-ask
Command: npx skills add https://github.com/cashwu/Keyify --skill spectra-ask

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec CLI.

What problem does it solve?

This Skill acts as a specialized knowledge base assistant, answering questions exclusively based on the content of openspec documents.

Core Features & Use Cases

  • Document-Grounded Answers: Ensures all responses are derived solely from provided specifications, preventing reliance on external knowledge.
  • Targeted Search: Utilizes a vector search mechanism to find relevant information within the openspec documentation.
  • Use Case: A developer needs to understand how a specific feature, like 'activity-bar badge functionality', works according to the project's specifications. They can ask the Skill, which will search the openspec documents and provide a precise answer based on that content.

Quick Start

Ask the spectra-ask skill a question about openspec documents, for example: "What are the design details for the restore-tab-badge-count change?"

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 to answer questions about project specifications?

To search openspec documents, you query the spectra-ask skill which uses vector search to find relevant information within openspec/specs/ and openspec/changes/archive/ directories. It retrieves answers grounded strictly in your provided specification content.

Can I retrieve answers from historical specification archives without including current specs?

Retrieving answers from historical archives prioritizes current openspec specifications over the openspec/changes/archive/ directory. The vector search mechanism searches both locations but weights current specifications higher when providing document-grounded answers.

Do I need the openspec CLI to query knowledge base documents for specific feature details?

You need the openspec CLI installed because the spectra-ask skill requires it for its search functionality to query openspec documents. This dependency enables the vector search mechanism to locate relevant project specification details.

How does document-grounded retrieval prevent irrelevant external knowledge in specification answers?

Document-grounded retrieval prevents irrelevant external knowledge by ensuring all responses are derived solely from provided openspec documents. The skill searches internal project specifications and answers exclusively based on that content.

What is the best way to ask about design details for a specific openspec change?

The best way to ask about openspec change design details is to query the skill directly with a specific question like asking for the design details of a particular change. The vector search targets the openspec documents to provide a precise answer.

Are there limitations when searching internal project knowledge using openspec documents?

Limitations when searching openspec documents include being restricted to content within openspec/specs/ and openspec/changes/archive/ directories. The skill cannot answer questions outside of the provided specification content and requires the openspec CLI.