clean-code

A set of general rules for writing, editing, reviewing, testing, and refactoring readable code.

In plain words
What is it for?
Use it during coding tasks to inspect nearby patterns, make focused edits, handle errors clearly, write deterministic tests, and run suitable checks.
Why use it?
It helps prevent unclear names, oversized functions, hidden errors, unnecessary changes, and tests that do not reliably check behavior.

Cursor rule for Cursor

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 rules/amartuvshins0404/clean-code-skills/clean-code
Clone the repo
git clone --depth 1 https://github.com/Amartuvshins0404/clean-code-skills

Made for: Cursor.

Per session 364 This file is loaded in full into every session.
When invoked 364 The same file — it is already loaded in full.
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 $0.00364 $0.00364
Opus 5 $0.00182 $0.00182
Sonnet 5 $0.00073 $0.00073
Haiku 4.5 $0.00036 $0.00036

Measured 2d ago against content hash 1229b5b4edb1, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

clean-code 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 2d 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.

.cursor/rules/clean-code.mdc · 40 lines

What it actually says

Clean Code

Use these rules for every coding task in Cursor.

Work Loop

  1. Clarify assumptions that affect behavior, tests, security, data, or architecture.
  2. Inspect nearby code and match existing idioms before editing.
  3. Make the smallest change that solves the request.
  4. Keep names, functions, modules, tests, and errors readable and explicit.
  5. Verify with the narrowest meaningful check, then expand checks when risk demands it.
  6. Review the diff for unrelated edits, speculative abstractions, and hidden failure paths.

Clean-Code Baseline

  • Names reveal intent and use domain language.
  • Functions and methods do one thing at one abstraction level.
  • Comments explain why, constraints, or tradeoffs; they do not excuse unclear code.
  • Classes, modules, components, scripts, jobs, and queries stay cohesive.
  • Boundaries around external systems are explicit and tested when risk warrants it.
  • Errors preserve context and are not swallowed silently.
  • Tests are readable, deterministic, and behavior-focused.
  • Concurrency makes ownership, ordering, cancellation, and shared state explicit.
  • Essential complexity (the problem) and accidental complexity (how it was built) are different; only the second is yours to fix in passing.
  • Once an interface has multiple users, every observable behavior is part of the contract.

Do Not

  • Do not rewrite unrelated code.
  • Do not reformat files outside the touched area.
  • Do not add future-proofing that the request did not need.
  • Do not impose one language's style on another language.
  • Do not claim success without fresh verification evidence.
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. 2d ago First seen · 40 lines · 364 tokens per session scan A 1229b5b4edb1

Subscribe to this mod's changes

clean-code is a cursor rule published in the GitHub repository Amartuvshins0404/clean-code-skills (2 stars, last pushed 4mo ago), licensed MIT. It adds 364 tokens to every session, about $0.0018 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.