skills/applying-code-principles/SKILL.md
Fundamental software principles - SOLID, DRY, Occam's Razor, Miller's Law, YAGNI, Readable Code. Use when: 原則, シンプル, 複雑, リファクタリング, 保守性, clean code, best practice.
npx skillsauth add thkt/dotclaude applying-code-principlesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Priority, thresholds, conflict resolution: see rules/PRINCIPLES.md and
rules/development/CODE_THRESHOLDS.md.
| Question | Principle | | --------------------- | ----------------------- | | Simpler way? | Occam's Razor | | <1 min to understand? | Miller's Law | | Duplicating? | DRY | | Needed now? | YAGNI | | CSS can do it? | Progressive Enhancement |
| Principle | Rule | | ----------------------- | ---------------------------------------------- | | DRY | Abstract on 3rd duplication (Rule of Three) | | SOLID | Interface only when 2nd implementation appears | | YAGNI | Build only if problem exists now | | Readable | New team member understands in < 1 minute | | Progressive Enhancement | HTML → CSS → JS (prefer earlier layer) |
documentation
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.
development
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).
tools
Internal helper for /think Step 11. Renders SOW.md + Spec.md as an integrated Astro view and returns a dev server URL.
development
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).