Coding Principles

Coding Principles is a Quality skill for Claude Code, published by shinpr in claude-code-workflows.

669 stars102 forkson shinpr/claude-code-workflowsAdded 2026/08/24Repository updated 2026/08/23

agent-skillsagentic-aiagentic-codingai-agentsanthropicclaude-codeclaude-code-pluginclaude-code-skillcode-qualitycode-reviewdeveloper-toolsdevelopment-workflowllm-orchestrationproductivitysubagents

Install in seconds

Install Coding Principles

Copy Coding Principles into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/shinpr/claude-code-workflows/tree/main/skills/coding-principles ~/.claude/skills/coding-principles

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/shinpr/claude-code-workflows.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/coding-principles/SKILL.md in shinpr/claude-code-workflows
Installs to: ~/.claude/skills/coding-principles
Collection: One of 25 skills cataloged from this repository
Category: Quality — 1354 skills

What Coding Principles does

Coding Principles provides language-agnostic guidance for writing maintainable, readable, and well-structured code. Use it when implementing features, refactoring, or reviewing code quality.

Coding Principles is cataloged under Quality on DirSkills. Coding Principles comes from a repository tagged agent-skills, agentic-ai, agentic-coding, ai-agents and anthropic.

Documentation

README

Excerpt

Language-Agnostic Coding Principles

Core Philosophy

Maintainability over Speed: Prioritize long-term code health over initial development velocity
Simplicity First: Choose the simplest solution that meets requirements (YAGNI principle)
Design Convergence: Deliver the current required outcome with the least new design surface. Selecting persistent state, public or cross-boundary contracts, behavioral modes, reusable abstractions, or component splits carries enough surface to justify the full convergence process first.
Explicit over Implicit: Make intentions clear through code structure and naming
Delete over Comment: Remove unused code instead of commenting it out

Code Quality

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Coding Principles

What else does shinpr publish alongside Coding Principles?
Coding Principles is one of 25 skills that DirSkills catalogs from shinpr/claude-code-workflows, the repository it ships in. Its siblings there include AI Developer Guide, Documentation Criteria and External Resource Context. Each one is a separate skill with its own page in this directory, installs the same way Coding Principles does, and is maintained by shinpr in that same repository. The rest of the collection is listed on the shinpr/claude-code-workflows page.
How does Coding Principles compare to other Quality skills?
Coding Principles ranks #1084 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Coding Principles against them. Open each page to compare what they document and how they install.