review-design

review-design is a skill for Claude Code, Codex from urmzd/dotfiles. It costs 102 tokens per session (1,782 once invoked), scanned A, original, Apache-2.0.

A set of practical software-design principles for deciding how code should be structured and changed. It covers ideas such as avoiding duplication, keeping parts independent, making future changes easier, and checking assumptions.

In plain words
What is it for?
Use it when choosing between designs, reviewing dependencies and boundaries, deciding whether an abstraction is worthwhile, or explaining why a code change should be simpler, more reversible, or less connected to other parts.
Why use it?
It helps developers reason about design choices instead of selecting patterns automatically. The guidance makes trade-offs clearer when code is becoming coupled, difficult to change, or harder to understand.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/urmzd/dotfiles/review-design
Any agent
npx skills add urmzd/dotfiles --skill review-design
Clone the repo
git clone --depth 1 https://github.com/urmzd/dotfiles

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for review-design

README.md
[![agentmods](https://agentmods.dev/badge/skills/urmzd/dotfiles/review-design.svg)](https://agentmods.dev/skills/urmzd/dotfiles/review-design)
Your own site
<a href="https://agentmods.dev/skills/urmzd/dotfiles/review-design"><img src="https://agentmods.dev/badge/skills/urmzd/dotfiles/review-design.svg" alt="Measured on agentmods" height="20"></a>
Per session 102 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,782 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00102 $0.01782
Opus 5 $0.00051 $0.00891
Sonnet 5 $0.00020 $0.00356
Haiku 4.5 $0.00010 $0.00178

Measured 5d ago against content hash f967daa43a2a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

review-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

dot_agents/skills/review-design/SKILL.md · 173 lines

How it starts

The opening of the file, as written. The whole thing — 173 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Pragmatic Programming

Layering: Principles layer above assess-quality (foundational framework) and are operationalized by write-code (tool/pattern picks). Use this skill when reasoning about why a design tradeoff matters; use assess-quality for the underlying quality framework; use write-code for concrete picks.

Principles from The Pragmatic Programmer (Hunt & Thomas) distilled into actionable rules for everyday development.

Core Philosophy

  • Care about your craft why spend your life developing software unless you care about doing it well?
  • Think critically question assumptions, challenge "because we've always done it that way"
  • Be a catalyst for change show people a future they can rally around (stone soup)
  • Remember the big picture don't get so absorbed in details that you forget the system as a whole (boiling frog)
  • Good enough software know when to stop; perfect is the enemy of shipped

ETC: Easy to Change

The fundamental design principle. Every decision should make future change easier.

  • When choosing between approaches, pick the one that's easier to change later
  • If you can't decide which path is more changeable, fall back on: make it replaceable
  • Decoupled code is easier to change; single-responsibility code is easier to change; well-named code is easier to change. ETC is the why behind all of them

DRY: Don't Repeat Yourself

Every piece of knowledge must have a single, unambiguous, authoritative representation within a system.

Violation Fix
Copy-pasted logic Extract shared function/module
Knowledge in code AND comments Let code be the authority; remove redundant comments
Same validation in client and server Single schema, generate both
Repeated config across environments Template or derive from one source
Data structure duplicated across types Single source type, derive others
  • DRY applies to knowledge, not text. Two functions with identical code but representing different knowledge are not DRY violations
  • Watch for DRY violations across: code, documentation, data schemas, API specs, build config

Read the full file on GitHub · 173 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 173 lines · 102 tokens per session scan A f967daa43a2a

Subscribe to this mod's changes

review-design is a skill published in the GitHub repository urmzd/dotfiles (3 stars, last pushed 23d ago), licensed Apache-2.0. It adds 102 tokens to every session and 1,782 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

benchling-integration

Benchling Python SDK and REST API integration for registry entities, inventory, ELN entries, workflows, Benchling Apps, and Data Warehouse queries. Use when automating lab data with benchling-sdk or the v2 API.

magic3007/dotfiles · 50 tokens

scan-commit

Automatically scan the repository for unstaged/untracked changes, group them into logical commits using hunk-level analysis, stage and commit them following Conventional Commits.

magic3007/dotfiles · 35 tokens

astropy

Core Python library for astronomy and astrophysics workflows that need Astropy APIs, including units/quantities, coordinates, FITS I/O, tables, time systems, WCS, and cosmology. Use when implementing or debugging astronomical data analysis code with Astropy.

magic3007/dotfiles · 56 tokens

esm

Comprehensive toolkit for EvolutionaryScale protein language models including ESM3 (generative multimodal design across sequence, structure, and function) and ESM C (efficient embeddings). Use for protein sequence/structure/function tasks, inverse folding, embeddings, variant design, and ESMFold2 structure prediction…

magic3007/dotfiles · 96 tokens

ralph-loop

Ralph Wiggum 迭代开发循环。三阶段工作流(需求→规划→构建),每阶段有 code review + 测试 gate。 触发词:ralph loop、迭代开发、interview me、plan system、build system。.

magic3007/dotfiles · 63 tokens

create-pr

Rebase from the latest origin/main, squash the commits from it, and then create a PR on github with intelligent commit messages based on staged changes.

magic3007/dotfiles · 34 tokens