skills.rest
blockscout
blockscoutOFFICIAL
Explore all skills by this author →
Website𝕏@blockscoutcomGitHub

consult-spec

Consult SPEC.md to verify architectural decisions and API specifications.

43|21|Updated Jun 3, 2025
Search Tags:#documentation#specification#requirements#design principles#code verification#source of truth
One-click install
npx skills add https://github.com/blockscout/mcp-server --skill consult-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: consult-spec
Source: https://github.com/blockscout/mcp-server/tree/main/.claude/skills/consult-spec
Command: npx skills add https://github.com/blockscout/mcp-server --skill consult-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that AI agents consult the authoritative specification (SPEC.md) before making implementation decisions, preventing deviations from requirements due to outdated or incorrect code.

Core Features & Use Cases

  • Authoritative Guidance: Provides unbiased information directly from the project's specification document.
  • Requirement Verification: Helps agents confirm design principles, API structures, and technical constraints before implementation.
  • Use Case: When an agent needs to design a new API endpoint, it first uses this skill to query SPEC.md for the required request/response formats and error handling strategies, ensuring compliance with project standards.

Quick Start

Use the consult-spec skill to ask about the pagination strategy.

Frequently Asked Questions about consult-spec

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

FAQPage Schema
How do I verify API specifications against the source of truth before implementation?▼

To verify API specifications against the source of truth, consult the authoritative SPEC.md document to confirm required request and response formats, error handling strategies, and technical constraints before proceeding with implementation.

What is a spec-first approach for AI agents?▼

A spec-first approach for AI agents involves consulting the authoritative specification document to provide unbiased design principles and requirements, preventing deviations caused by outdated or incorrect implementation code.

Why does an AI agent need to consult the specification before coding?▼

An AI agent needs to consult the specification before coding to prevent architectural deviations and ensure compliance with project standards by isolating specification review from implementation code analysis.

How do I check architectural decisions against project requirements?▼

Check architectural decisions against project requirements by querying the specification document to verify technical constraints and design principles, ensuring all structural choices match the defined source of truth.

Can I use this to find pagination strategies for a new API endpoint?▼

Yes, you can query the specification document to find the required pagination strategies and structural formats for a new API endpoint, ensuring the design complies with established project standards.

Related Skills

Explore More Software Engineering Skills→
jonnymuirjonnymuir
1

design-source-of-truth

Consolidate fragmented design specifications into a single source-of-truth document.

Community
Intermediate
ArabelaTsoArabelaTso
142

verified-pseudocode-extractor

Extract language-agnostic pseudocode from Isabelle/HOL and Coq verified programs.

Community
Advanced
camelranchentertainmentcamelranchentertainment
1

spec-miner

Extract specifications, dependencies, and architectural decisions from codebases.

Community
Advanced
j-showj-show

doc-helper

Generate JSDoc, inline comments, and README files from source code.

Official
Intermediate