trace-analysis

Evaluate code changes against TRACE framework quality dimensions.

8|3|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/jwilger/claude-code-setup --skill trace-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace-analysis
Source: https://github.com/jwilger/claude-code-setup/tree/main/skills/trace-analysis
Command: npx skills add https://github.com/jwilger/claude-code-setup --skill trace-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the assessment of code quality and maintainability using the TRACE framework, saving you from subjective and time-consuming manual reviews. It provides an objective score across five critical dimensions, identifies complexity violations, and offers actionable remediation steps, ensuring your codebase remains clean, understandable, and easy to evolve.

Core Features & Use Cases

  • TRACE Framework Evaluation: Systematically evaluate code changes across Type-first thinking, Readability, Atomic scope, Cognitive budget, and Essential only dimensions.
  • Automated Quality Gates: Automatically calculate an overall TRACE score and apply mandatory thresholds (e.g., ≥70% overall, ≥50% per dimension) to ensure high-quality code.
  • Actionable Remediation: Receive specific, actionable recommendations to fix complexity violations, improving code design and maintainability.
  • Use Case: Automatically assess the maintainability and cognitive load of your code changes before they're merged, ensuring high-quality, understandable code that's easy to evolve.

Quick Start

Initiate a TRACE analysis on your code changes.

The AI will automatically evaluate the code and generate a comprehensive report.

Example report snippet:

TRACE Analysis Report

=====================

Overall Score: 85%

Status: PASS

Dimension Breakdown:

- Type-First (25%): 90% [PASS]