thkt/use-context-reviewer-readability
skills/use-context-reviewer-readability/SKILL.md
Code readability review. Do NOT use for security (use-context-reviewer-security), type errors (use-context-reviewer-strictness), error handling (use-context-reviewer-silence), or test design (use-context-reviewer-testability).
$ install --global
skillsauthnpx skillsauth add thkt/dotclaude 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: Jun 12, 2026, 2:39 AM29.8s5 files scanned
SKILL.md
- name:
- use-context-reviewer-readability
- description:
- Code readability review. Do NOT use for security (use-context-reviewer-security), type errors (use-context-reviewer-strictness), 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
- user-invocable:
- false
Readability Review
Thresholds are based on cognitive limits (working memory, one-screen focus) and established metrics (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 | processData() (vague) | 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/outcome
documentation
VerifiedTrustedCommunity
Generates and updates .claude/OUTCOME.md interactively. When the file is absent or empty (no Behavior / all sections TBD), collects content via AskUserQuestion and writes the stub; when present, shows the current state and applies updates.
9SKILL.mdUpdated Jun 12, 2026
thkt/audit-skill-craft
development
VerifiedTrustedCommunity
Judge a SKILL.md against craft axes (single responsibility, description distinctiveness, imperative voice, verifiable completion, calibration, progressive disclosure) and apply the fixes the audit surfaces. Do not use for format-presence-only checks (use reviewer-prompt) or reproducibility loops (use /tuning).
9SKILL.mdUpdated Jun 11, 2026
thkt/use-workflow-plan-preview
tools
VerifiedTrustedCommunity
Internal helper for /think Step 11. Renders SOW.md + Spec.md as an integrated Astro view and returns a dev server URL.
9SKILL.mdUpdated Jun 1, 2026
thkt/probe
development
VerifiedTrustedCommunity
Extract repository spec while detecting bugs, spec gaps, and consistency drift via dual-purpose documentation. OUTCOME.md-axis question-driven exploration with ephemeral output. Do NOT use for code review (use /audit or /polish), feature implementation (use /code), planning only (use /think), or single-bug fix (use /fix).
9SKILL.mdUpdated Jun 1, 2026