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.