tech-spec

Parse technical specification markdown to extract structure and quality metrics.

1|2|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/montymi/claude-config --skill tech-spec-montymi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-spec
Source: https://github.com/montymi/claude-config/tree/main/skills/tech-spec
Command: npx skills add https://github.com/montymi/claude-config --skill tech-spec-montymi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tree-sitter, tree-sitter-markdown, and includes scripts (resource) components.

What problem does it solve?

Technical Specification documents are often large and hard to validate for completeness and readiness. This Skill automates structural analysis, quality checks, and actionable insights to accelerate implementation planning.

Core Features & Use Cases

  • Structural analysis using tree-sitter-markdown to extract sections, feature catalogs (F-xxx), components, technologies, and integrations.
  • Comprehensive quality metrics: section coverage, feature completeness, hierarchy, and risk indicators.
  • Fallback parsing with regex when tree-sitter is unavailable to maintain resilience.
  • Use Case: Review a full tech spec to verify it contains all required sections and a complete feature catalog before development begins.

Quick Start

Run the parser on your tech spec markdown to generate a structured assessment report.

Frequently Asked Questions about tech-spec

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

FAQPage Schema
How do I validate a technical specification document for completeness before development?

You can validate a technical specification by parsing the markdown to extract sections, feature catalogs (F-xxx), and component designs. This generates verifiable quality metrics like section coverage and feature completeness to assess implementation readiness.

How does tree-sitter-markdown work for tech spec structure validation?

Tree-sitter-markdown parses the technical specification document syntax to extract structural elements like sections and feature catalogs. If tree-sitter is unavailable, the analysis falls back to regex parsing to maintain resilience and continue generating quality metrics.

What is a feature catalog analysis in technical specification documents?

Feature catalog analysis extracts F-xxx feature entries from technical specs to verify completeness and hierarchy. It captures data such as feature entries, component interfaces, and technologies to ensure all required features are documented before implementation begins.

Can I review architecture and deployment considerations in a tech spec automatically?

Yes, automated tech spec review parses architecture and deployment considerations alongside component designs and integration details. It extracts component interfaces and technologies to produce structured assessment reports for implementation planning.

Do I need tree-sitter installed to analyze technical specification markdown files?

No, tree-sitter is not strictly required to analyze technical specification markdown files. While tree-sitter-markdown provides structural parsing, the Skill includes a regex fallback parsing mechanism to maintain resilience when tree-sitter is unavailable.

What are the limitations of using regex fallback for tech spec structure validation?

Regex fallback parsing for tech spec validation may lack the syntactic precision of tree-sitter-markdown for extracting complex hierarchies and component interfaces. It maintains resilience but might miss nuanced structural relationships within the technical specification document.