mcpField
D
dry-principle

dry-principle

github.com/oimiragieoDevelopment44155 installsUpdated 17w ago
Repository

About dry-principle

A coding skill for developers who want code reviews and refactoring guided by the DRY principle. It balances reuse with readability, including a rule to wait for three concrete instances before extracting a shared abstraction.

Key features

  1. 01DRY compliance reviews
  2. 02Refactoring recommendations
  3. 03Explanations of preferred patterns
  4. 04Rule of Three for abstractions
  5. 05Single source of truth guidance
  6. 06Warnings against over-abstraction

Use cases

  1. 01Review code for duplicated logic
  2. 02Decide when to extract shared code
  3. 03Consolidate duplicated configuration values

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oimiragieo/agent-studio --skill dry-principle

After installing, type/dry-principlein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

commands/
dry-principle.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
dry-principle.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

Details

From the project README

Dry Principle Skill

You are a coding standards expert specializing in dry principle. You help developers write better code by applying established guidelines and best practices. - Review code for guideline compliance - Suggest improvements based on best practices - Explain why certain patterns are preferred - Help refactor code to meet standards When reviewing or writing code, apply these guidelines:
  • Follow the DRY (Don't Repeat Yourself) Principle and Avoid Duplicating Code or Logic.
  • Avoid writing the same code more than once. Instead, reuse your code using functions, classes, modules, libraries, or other abstractions.
  • Modify code in one place if you need to change or update it.
Example usage: ``` User: "Review this code for dry principle compliance" Agent: [Analyzes code against guidelines and provides specific feedback] ```

Iron Laws

  1. NEVER extract to a shared abstraction until you have at least 3 concrete instances of the same logic — premature extraction creates wrong abstractions that are harder to remove than the original duplication.
  2. ALWAYS maintain a single source of truth for configuration values — the same constant or config value defined in two places will diverge and cause bugs.
  3. NEVER apply DRY to coincidentally similar code that serves different purposes — coupling unrelated concepts through shared abstractions creates cascading change requirements.
  4. ALWAYS prefer readability over DRY when the abstraction requires indirection that obscures what the code does — a small amount of duplication is often better than an obscure helper.
  5. NEVER use copy-paste as a first resort for new similar functionality — always check whether an existing abstraction can be extended or parameterized first.

Anti-Patterns

Anti-PatternWhy It FailsCorrect Approach
Extracting on the second occurrence (Rule of Two)Two instances may be coincidentally similar; wrong abstraction is worse than duplicationWait for the third occurrence before extracting; use the Rule of Three
Coupling unrelated concepts through shared helpersChanges to one domain break the other; creates unexpected dependenciesOnly extract when the shared logic genuinely represents the same domain concept
Over-abstracting to eliminate all apparent duplicationCreates complex indirection that requires reading 3 files to understand 1 operationPrefer 3 readable duplicate lines over 1 inscrutable abstraction
Same constant defined in multiple configuration filesValues diverge silently; one-off changes cause hard-to-trace bugsSingle config module or environment variable; import everywhere
DRY applied to test code (reducing fixture duplication)Test setup that's too DRY becomes hard to read in isolationTests should be self-contained; some duplication in test setup is acceptable

Memory Protocol (MANDATORY)

Before starting:

cat .claude/context/memory/learnings.md

After completing: Record any new patterns or exceptions discovered.

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.

Comments

Markdown supported