cognitive-load-analyzer

Analyze codebase cognitive load across eight dimensions with a 0-1000 index.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill cognitive-load-analyzer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cognitive-load-analyzer
Source: https://github.com/maroffo/claude-forge/tree/main/skills/cognitive-load-analyzer
Command: npx skills add https://github.com/maroffo/claude-forge --skill cognitive-load-analyzer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill quantifies the cognitive load of a codebase, providing a clear, actionable score to identify areas that are difficult to understand and maintain.

Core Features & Use Cases

  • Cognitive Load Index (CLI): Generates a score from 0-1000 based on 8 dimensions of complexity.
  • Dimension Breakdown: Details scores for Structural Complexity, Nesting Depth, Volume/Size, Naming Quality, Coupling, Cohesion, Duplication, and Navigability.
  • Actionable Recommendations: Suggests specific refactoring steps based on the highest-contributing dimensions.
  • Use Case: Before undertaking a major refactor of a legacy system, run this Skill to pinpoint the most complex modules and functions, guiding your efforts for maximum impact.

Quick Start

Run the cognitive load analyzer skill on the current project directory.

Frequently Asked Questions about cognitive-load-analyzer

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

FAQPage Schema
How do I measure code complexity and cognitive load in a legacy codebase?

You can quantify codebase complexity by running this Skill, which evaluates nesting depth, coupling, cohesion, and naming quality to produce a 0-1000 Cognitive Load Index score with actionable refactoring recommendations.

What is the best way to identify which modules need refactoring before a major rewrite?

The best way to identify refactoring targets is to analyze codebase cognitive load, which scores structural complexity and duplication across modules to guide your maintenance efforts for maximum impact.

Does the cognitive load analyzer support polyglot codebases with multiple programming languages?

Yes, the cognitive load analyzer supports polyglot codebases, applying static analysis and optional LLM assessment to quantify complexity across mixed-language projects using deterministic sampling.

How does static analysis calculate the Cognitive Load Index for large projects?

Static analysis calculates the Cognitive Load Index for large projects using deterministic sampling, evaluating eight dimensions like volume, navigability, and coupling to output a 0-1000 complexity score.

What specific complexity dimensions are evaluated when analyzing code maintainability?

When analyzing code maintainability, the evaluation covers eight complexity dimensions: Structural Complexity, Nesting Depth, Volume/Size, Naming Quality, Coupling, Cohesion, Duplication, and Navigability.