Coding Principles

Taal-agnostische codeerprincipes voor onderhoudbaarheid, leesbaarheid en codekwaliteit

Door shinpr · shinpr/claude-code-workflows

Getest · Werkt ★ 8.8/10

Coding Principles — Taal-agnostische codeerprincipes voor onderhoudbaarheid, leesbaarheid en codekwaliteit

Wat het doet

Een taal-agnostische checklist van codeerprincipes die functieontwerp, foutafhandeling, dependency injection, commentaar, refactoring en veilige defaults omvat, plus een security-checks referentie voor review. Activeert bij het implementeren van features, refactoring of het reviewen van codekwaliteit. Stuurt gegenereerde code naar geparametriseerde queries, secret-safe logging, veilige hashing, benoemde constanten en kleine single-responsibility functies.

Testrapport

SKILL.md en het ene verwezen bestand (references/security-checks.md, HTTP 200) opgehaald uit de dev-skills kopie; frontmatter heeft name+description en geen hardgecodeerde paden of beveiligingsrisico's. Voor output schreef ik dezelfde registerUser functie tweemaal: een baseline natuurlijk geschreven, daarna een die de body strikt volgde. De skill-versie repareerde concreet echte defecten in mijn baseline — SQL string concatenatie werd een geparametriseerde query, een console.log die het plaintext wachtwoord lekte werd een username-only log, MD5 werd pbkdf2 met salt, het magische nummer 13 werd MINIMUM_AGE, en ruwe e.message stopte met lekken naar de aanroeper. Trigger zinsneden beoordeeld: "refactor this 300-line UserService" JA, "review my PR for code quality" JA, "implement a caching layer with clean maintainable structure" JA, "what's the difference between TCP and UDP" NEE, "set up a GitHub Actions CI pipeline" NEE — alle 5 correct.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/coding-principles-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-principles-src/dev-skills/skills/coding-principles ~/.claude/skills/coding-principles
# Places SKILL.md at ~/.claude/skills/coding-principles/SKILL.md plus references/security-checks.md
# No deps, no scripts, no API keys — pure guidance skill.
# Identical copies also live under dev-workflows-frontend/ and dev-workflows-fullstack/ in the same repo.
# Plugin alternative: /plugin marketplace add shinpr/claude-code-workflows then /plugin install dev-workflows@claude-code-workflows

Commando's en voorbeeldprompts

/coding-principlesTaal-agnostische codeerprincipes voor onderhoudbaarheid, leesbaarheid en codekwaliteit

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Review this function for maintainability issues
Refactor this code to be more readable
Check this feature implementation against coding principles

Volledig rapport (Engels) →