OpenSkillIndex← back to search
claude-code

Agent-skills-standard common-best-practices

Enforce SOLID principles, guard-clause style, function size limits, and intention-revealing naming across all languages. Use when refactoring for readability, applying clean-code patterns, reviewing naming conventions, or reducing function complexity. (triggers: **/*.ts, **/*.tsx, **/*.go, **/*.dart, **/*.java, **/*.kt, **/*.swift, **/*.py, solid, kiss, dry, yagni, naming, conventions, refactor, clean code)

install
source · Clone the upstream repo
git clone https://github.com/HoangNguyen0403/agent-skills-standard
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/HoangNguyen0403/agent-skills-standard "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agent/skills/common/common-best-practices" ~/.claude/skills/hoangnguyen0403-agent-skills-standard-common-best-practices && rm -rf "$T"
manifest: .agent/skills/common/common-best-practices/SKILL.md
source content

Global Best Practices

Priority: P0 (FOUNDATIONAL)

Core Principles

  • SOLID: Follow SRP (One reason to change), OCP (Open to extension), LSP, ISP, DIP.
  • KISS/DRY/YAGNI: Favor readability. Abstract repeated logic. No "just in case" code.
  • Naming: Intention-revealing (
    isUserAuthenticated
    > 
    checkUser
    ). Follow language casing.

Code Hygiene

  • Size Limits: Functions < 30 lines. Services < 600 lines. Utils < 400 lines.
  • Early Returns: Use guard clauses to prevent deep nesting.
  • Comments: Explain why, not what. Refactor instead of commenting bad code.
  • Sanitization: Validate all external inputs.

Anti-Patterns

  • No hardcoded constants: Use named config/env vars.
  • No deep nesting: Guard clauses eliminate the Pyramid of Doom.
  • No global state: Prefer dependency injection.
  • No empty catches: Always handle, log, or rethrow.

References