Skill
Community

foundations

Install
1
Install the plugin
$
npx claudepluginhub levifig/loaf --plugin loaf

Want just this skill?

Then install: npx claudepluginhub u/[userId]/[slug]

Description

Establishes code quality, commit conventions, documentation standards, and security patterns.

Tool Access

This skill is limited to using the following tools:

ReadWriteEditBashGlobGrep
Supporting Assets
View in Repository
references/code-review.md
references/code-style.md
references/commits.md
references/debugging.md
references/diagrams.md
references/documentation-review.md
references/documentation.md
references/hypothesis-tracking.md
references/observability.md
references/permissions.md
references/production-readiness.md
references/review.md
references/security-review.md
references/security.md
references/tdd.md
references/test-debugging.md
references/verification.md
scripts/check-changelog-format.sh
scripts/check-commit-msg.sh
scripts/check-python-style.py
Skill Content

Code Standards

Engineering foundations for consistent, secure, and well-documented code.

Contents

  • Topics
  • Available Scripts
  • Critical Rules
  • Naming Conventions
  • Commit Types
  • Test Patterns

Topics

TopicReferenceUse When
Code Stylereferences/code-style.mdWriting Python/TypeScript code, naming variables
Commitsreferences/commits.mdWriting commit messages, creating PRs, branching
Diagramsreferences/diagrams.mdCreating Mermaid diagrams, visualizing architecture
Documentationreferences/documentation.mdWriting ADRs, API docs, changelogs
Securityreferences/security.mdThreat modeling, managing secrets, compliance checks
Debuggingreferences/debugging.mdSystematically debugging issues with hypotheses
Hypothesis Trackingreferences/hypothesis-tracking.mdManaging multiple hypotheses during investigation
Test Debuggingreferences/test-debugging.mdFixing flaky tests, isolation issues, state pollution
TDDreferences/tdd.mdWriting tests first, red/green/refactor cycle
Verificationreferences/verification.mdVerifying work before claiming done
Code Reviewreferences/code-review.mdRequesting or receiving code reviews
Permissionsreferences/permissions.mdConfiguring tool allowlists, sandbox, agent permissions

Available Scripts

ScriptUsageDescription
scripts/check-commit-msg.shcheck-commit-msg.sh <file>Validate commit message format
scripts/check-python-style.pycheck-python-style.py <dir>Check Python style (type hints, docstrings)
scripts/check-test-naming.shcheck-test-naming.sh <dir>Check test file/function naming
scripts/validate-adr.pyvalidate-adr.py <file>Validate ADR structure
scripts/check-changelog-format.shcheck-changelog-format.sh <file>Check micro-changelog format
scripts/check-secrets.shcheck-secrets.sh <dir>Scan for hardcoded secrets
scripts/validate-compliance.pyvalidate-compliance.py <file>Validate security checklist completion

Critical Rules

Always

  • Use type hints on all public functions
  • Write atomic commits (one logical change)
  • Use imperative mood in commit messages
  • Validate inputs at trust boundaries
  • Log security events (without secrets)
  • Include micro-changelog at document bottom

Never

  • Commit secrets, passwords, or API keys
  • Document APIs before they ship
  • Use bare except: clauses
  • Force push to main/master
  • Log sensitive data or stack traces to users
  • Skip commit signing without explicit permission

Naming Conventions

ContextPythonTypeScript
Filessnake_case.pyPascalCase.tsx (components)
Functionssnake_casecamelCase
ClassesPascalCasePascalCase
ConstantsUPPER_SNAKEUPPER_SNAKE
Teststest_<unit>_<scenario>_<result>describe/it blocks

Commit Types

TypeUse ForVersion Impact
featNew featuresMinor bump
fixBug fixesPatch bump
refactorCode restructuringNone
docsDocumentation onlyNone
testTest additions/updatesNone
choreMaintenance, depsNone
perfPerformance improvementsPatch bump

Test Patterns

Scenario-based fixture naming:

  • *_perfect - Complete, valid data (happy path)
  • *_degraded - Partial data, quality issues
  • *_chaos - Edge cases, malformed data

Coverage target: 70% minimum across all components.

Stats
Stars1
Forks0
Last CommitFeb 21, 2026

Similar Skills