Claude-skill-registry code-layout-evaluation-principles

Evaluate code layout quality based on accuracy, consistency, readability, and maintainability rather than aesthetics. Use when establishing coding standards, reviewing code formatting, or making decisions about layout conventions.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/code-layout-evaluation-principles" ~/.claude/skills/majiayu000-claude-skill-registry-code-layout-evaluation-principles && rm -rf "$T"

manifest: skills/data/code-layout-evaluation-principles/SKILL.md

Code Layout Evaluation Principles

Apply these principles when evaluating or establishing code layout standards.

Primary Priority

Clarify logical organization of code

Layout should first and foremost make the code's logical structure clear and understandable.

Evaluation Criteria (in order of importance)

Accuracy - Layout correctly represents code structure
Consistency - Layout follows established conventions throughout
Readability - Layout enhances code comprehension
Maintainability - Layout supports easy modification

Secondary Priority

Aesthetics

Aesthetics are a distant second priority
If the above criteria are met and underlying code is good, layout will naturally look good
Never sacrifice clarity for beauty

Importance of Conventions

Having a convention is more important than the specific details of the convention
Inconsistent layout conventions actually harm readability
Consistency across the codebase is more valuable than any particular style choice

Result

Layout quality is scored based on logical clarity, not visual appeal
Standards emphasize consistency and maintainability over aesthetics
Code is easier to understand and modify