archivist-readability-auditor

Community

Audit project readability without touching code.

Authorrfowler1994
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Report-only Project Archivist audit for maintainability and readability issues. Use when asked to find long files, unclear names, deeply nested logic, mixed responsibilities, hard-to-scan components, missing comments around non-obvious logic, outdated comments, magic numbers, or unclear control flow.

Core Features & Use Cases

  • Identify long files and deeply nested logic that slow development.
  • Flag unclear names for files, functions, variables, components, or concepts.
  • Produce standardized audit reports under docs/code-audits/reports/ to support refactoring and documentation.

Quick Start

Run a focused audit over the codebase to surface readability issues and generate a report under docs/code-audits/reports/.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: archivist-readability-auditor
Download link: https://github.com/rfowler1994/project-archivist/archive/main.zip#archivist-readability-auditor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.