Stats
Actions
Tags
From ship
Reviews code readability using cognitive load thresholds (function lines ≤30, nesting ≤3, McCabe complexity ≤10) and naming/comment/abstraction patterns.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ship:use-context-reviewer-readabilityWhen to use
可読性, 明確, 命名, 変数名, 関数名, ネスト, 関数設計, コメント, 複雑, Miller's Law, ミラーの法則, 認知負荷, AI-generated, 過剰設計
reviewer-readabilityThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Thresholds are based on cognitive limits (working memory, one-screen focus) and established metrics (McCabe complexity).
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 |
| 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 |
| 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 |
npx claudepluginhub thkt/dotclaude --plugin toolkitProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.