thkt/use-context-reviewer-readability
skills/use-context-reviewer-readability/SKILL.md
Code readability review. Do NOT use for security (use-context-reviewer-security), error handling (use-context-reviewer-silence), or test design (use-context-reviewer-testability).
$ install --global
skillsauthnpx skillsauth add thkt/claude-config use-context-reviewer-readabilityInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 27, 2026, 3:32 AM179.5s5 files scanned
SKILL.md
- name:
- use-context-reviewer-readability
- description:
- Code readability review. Do NOT use for security (use-context-reviewer-security), error handling (use-context-reviewer-silence), or test design (use-context-reviewer-testability).
- when_to_use:
- 可読性, 明確, 命名, 変数名, 関数名, ネスト, 関数設計, コメント, 複雑, Miller's Law, ミラーの法則, 認知負荷, AI-generated, 過剰設計
- allowed-tools:
- Read Task Bash(ugrep:*) Bash(bfs:*)
- agent:
- reviewer-readability
- context:
- fork
- background:
- false
- user-invocable:
- false
Readability Review
Thresholds are based on cognitive limits such as working memory and one-screen focus, and established metrics such as McCabe complexity.
| Target | Recommended | Why | | --------------------- | ----------- | -------------------------------------------- | | Function lines | ≤30 | One-screen readability | | File lines | ≤400 | Module-level cognitive ceiling | | Nesting depth | ≤3 | Branch tracking within working memory | | Function arguments | ≤3 | Argument order memorization limit | | Cyclomatic complexity | ≤10 | McCabe 1976: testable without path explosion |
Detection
| ID | Pattern | Fix |
| --- | ----------------------------- | -------------------------------- |
| RD1 | Vague processData() | validateUserEmail() |
| RD1 | Misleading identifiers | Names reveal intent |
| RD2 | Nesting > 3 levels | Guard clauses, extract functions |
| RD2 | Function > 30 lines | Decompose |
| RD3 | Comment: // increment i | Delete; self-evident |
| RD3 | Comment: // TODO: fix later | Create issue or fix now |
| RD4 | Interface for single impl | Remove until 2nd impl |
| RD4 | Class for stateless logic | Pure function |
| RD5 | > 5 function parameters | Config object or decompose |
References
| Topic | File | | --------------- | -------------------------------------------------- | | Control Flow | ${CLAUDE_SKILL_DIR}/references/control-flow.md | | Comments | ${CLAUDE_SKILL_DIR}/references/comments-clarity.md | | AI Antipatterns | ${CLAUDE_SKILL_DIR}/references/ai-antipatterns.md | | Naming | ${CLAUDE_SKILL_DIR}/references/naming.md |
Related Skills
thkt/use-cli-herdr
tools
VerifiedTrustedCommunity
Delegate implementation to codex (coder) via the herdr-agentchat plugin and drive a two-pane conversation to completion.
11SKILL.mdUpdated Jul 27, 2026
thkt/scribe
development
VerifiedTrustedCommunity
Extract recurring patterns from past closed PRs/issues and the research findings in workspace/research/, verify them against the latest code, and propose them to docs/wiki/ via PR.
11SKILL.mdUpdated Jul 20, 2026
thkt/dr
development
VerifiedTrustedCommunity
Create Decision Records (DR) in MADR v4 format with auto-numbering.
11SKILL.mdUpdated Jul 15, 2026
thkt/polish
development
VerifiedTrustedCommunity
Codex review + cleanup. Findings are challenged by critic-audit, not aggregated as facts, and fixes are applied directly. Do NOT use for internal multi-reviewer deep audits or findings reports (use /audit).
11SKILL.mdUpdated Jul 14, 2026