analysis

Analyze software projects with six modules and generate evidence-backed reports.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill analysis-usetheodev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analysis
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/analysis
Command: npx skills add https://github.com/usetheodev/theo-ui --skill analysis-usetheodev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate a project's direction using empirical evidence rather than opinions, by applying a structured analysis of benchmarks, complexity metrics, architecture fitness, and scalability projections.

Core Features & Use Cases

  • Hypothesis-driven assessment: generate testable hypotheses about architecture and performance.
  • Plan-binding analysis: opt-in via analysis-config.txt and an optional plan slug to align claims with project goals.
  • Six-module analysis: run A1-A6 modules and produce a comprehensive, evidence-backed report.
  • Knowledge-base audits: output an auditable, findings-rich document suitable for baseline tracking and governance.

Quick Start

Invoke /analysis with an optional plan-slug to bind analysis to a plan's architecture claims and generate the hypothesis-driven report.

Frequently Asked Questions about analysis

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

FAQPage Schema
How do I validate software architecture using empirical evidence instead of opinions?

Architecture validation relies on empirical evidence by applying structured analysis to benchmarks, complexity metrics, and scalability projections. This approach generates hypothesis-driven reports to test specific architecture and performance claims rather than relying on subjective opinions.

What is hypothesis-driven trajectory analysis for a released codebase?

Hypothesis-driven trajectory analysis evaluates a released codebase by generating testable hypotheses about its architecture and performance. It produces an auditable, findings-rich knowledge-base document suitable for baseline tracking and governance based on empirical metrics.

How do I run a scalability and complexity metrics analysis on my software project?

Run scalability and complexity metrics analysis by invoking the analysis process on a released codebase. It executes six analysis modules to produce a comprehensive, evidence-backed report assessing architecture fitness and scalability projections.

Can I align software architecture benchmarks with specific project goals and plans?

Yes, you can align architecture benchmarks with project goals by opting in via an analysis-config.txt file and supplying a plan slug. This plan-binding mechanism ensures the assessment validates trajectory claims against the defined project architecture goals.

Does trajectory validation require any specific configuration or dependencies?

Trajectory validation requires no external dependencies but needs an opt-in configuration file named analysis-config.txt applied per project. It operates on released codebases and optionally accepts a plan slug to bind the empirical assessment to specific architecture claims.

What metrics are included in an evidence-based architecture fitness report?

An evidence-based architecture fitness report includes metrics from six analysis modules covering benchmarks, complexity metrics, architecture fitness, and scalability projections. It outputs a comprehensive knowledge-base audit designed for baseline tracking and governance.