speq_skill

Enforce SpeQ specification rules for AI code generation sessions.

141|9|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/speq-ai/speq --skill speq-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speq_skill
Source: https://github.com/speq-ai/speq/tree/main
Command: npx skills add https://github.com/speq-ai/speq --skill speq-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SpeQ SKILL provides a behavioral contract that an AI must follow when operating on a SpeQ specification, ensuring consistent interpretation and zero room for ambiguity.

Core Features & Use Cases

  • Internalizes VOCABULARY, CONTRACTS, and CLASSIFY blocks before any code generation.
  • Enforces immutability and a closed-world assumption to achieve reproducible AI outputs.
  • Guides session startup and governance to align agents across models and sessions.

Quick Start

Load this SKILL alongside your .speq file and complete the session-start steps before generating any code.

Frequently Asked Questions about speq_skill

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

FAQPage Schema
How do I enforce consistent AI behavior when working with specifications?

To enforce consistent AI behavior with specifications, you apply a behavioral contract that internalizes VOCABULARY, CONTRACTS, and CLASSIFY blocks before code generation. This eliminates interpretation ambiguities and ensures reproducible outputs.

What is the closed-world assumption in AI code generation?

The closed-world assumption in AI code generation restricts the model to explicitly defined specification data, rejecting undefined elements. Enforcing this immutability ensures reproducible outputs and prevents unauthorized structural deviations across sessions.

How do I start an AI session using a SpeQ specification?

To start an AI session using a SpeQ specification, load the behavioral skill alongside your spec file and complete the documented session-start steps. You must internalize the specification blocks before generating any code.

Why does my AI assistant generate inconsistent code from the same specification?

AI assistants generate inconsistent code from the same specification due to interpretation ambiguities. Applying a strict behavioral contract enforces immutability and a closed-world principle, aligning the model's outputs across multiple sessions.

Do I need to define VOCABULARY and CONTRACTS before generating code from a spec?

Yes, you must define and internalize VOCABULARY and CONTRACTS before generating code from a spec. This sequence ensures the AI understands the domain language and rules, producing reproducible and accurate outputs.

Can I use behavioral contracts to align AI agents across different models?

Yes, you can use behavioral contracts to align AI agents across different models. By enforcing a closed-world principle, immutability, and strict session-start governance, the specification yields consistent outputs regardless of the underlying model.