spec-analysis

Analyze specifications into 8-dimensional Shannon-based complexity scores and domain percentages.

2|Updated Sep 30, 2025
One-click install
npx skills add https://github.com/krzemienski/shannon-framework --skill spec-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-analysis
Source: https://github.com/krzemienski/shannon-framework/tree/main/shannon-plugin/skills/spec-analysis
Command: npx skills add https://github.com/krzemienski/shannon-framework --skill spec-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill transforms vague project specifications into objective, actionable intelligence. It prevents underestimation of complexity and ensures every project starts with a clear, data-driven plan, saving time and resources.

Core Features & Use Cases

  • 8-Dimensional Complexity Scoring: Analyzes specifications across 8 dimensions (structural, cognitive, technical, etc.) to produce a 0.0-1.0 complexity score and interpretation.
  • Domain Detection & MCP Recommendations: Automatically identifies project domains (Frontend, Backend, Database) with percentages and recommends optimal MCP servers.
  • 5-Phase Plan Generation: Creates a tailored 5-phase implementation plan with validation gates, timelines, and deliverables, customized to your project's unique needs.
  • Use Case: Provide a project specification and instantly receive a detailed report including a complexity score, domain breakdown, recommended AI tools, and a complete phase-by-phase execution plan, all saved for future reference.

Quick Start

Use spec-analysis to analyze the attached project specification 'new-feature-spec.md'.

Frequently Asked Questions about spec-analysis

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

FAQPage Schema
How do I score project complexity across multiple dimensions?

Complexity scoring analyzes specifications across 8 dimensions—structural, cognitive, coordination, temporal, technical, scale, uncertainty, and dependencies—producing a 0.0-1.0 objective score. Submit your requirements or design document to receive a Shannon-based complexity assessment that prevents underestimation and informs realistic planning.

Can I automatically detect which domains my project needs?

Domain detection identifies Frontend, Backend, Database, DevOps, and infrastructure components within your specification, returning percentages for each. This analysis recommends optimal MCP servers matched to your project's detected tech stack, ensuring you allocate resources to the right domains.

What does a 5-phase implementation plan include?

Phase planning generates a tailored 5-phase execution roadmap with validation gates, timelines, and deliverables specific to your project's complexity profile. Each phase includes concrete milestones and checkpoints to track progress and catch risks early.

How do I use specification analysis to prevent project underestimation?

Feed your multi-paragraph requirements, feature lists, or design documents into specification analysis to surface hidden complexity across technical, coordination, and uncertainty dimensions. The objective score and domain breakdown reveal scope that informal estimates typically miss.

Does this work with design documents and feature lists?

Yes, specification analysis accepts multi-paragraph requirements, feature lists, and design documents as input. It produces consistent 8-dimensional complexity scores and domain percentages regardless of source format, enabling comparison across different project proposal styles.

What's the difference between complexity scoring and a typical project estimate?

Complexity scoring uses objective Shannon-based mathematics across 8 dimensions rather than subjective guessing, eliminating bias and producing reproducible results. Unlike traditional estimates, it quantifies structural and coordination overhead, not just task count, revealing true project risk.