clean-code

clean-code is a skill for Claude Code, Codex from SecondLifes/delphi-expert. It costs 53 tokens per session (1,157 once invoked), scanned A, a copy of Delphi Clean Code, MIT.

Practical standards for writing new Delphi code that is simple, focused, and consistent. It covers naming, method size, responsibilities, reuse, and avoiding unnecessary features.

In plain words
What is it for?
Use it when writing Delphi classes, methods, variables, or project conventions for new code.
Why use it?
It helps make new code easier to read, maintain, and extend without adding needless complexity.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it when writing Delphi classes, methods, variables, or project conventions for new code.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/secondlifes/delphi-expert/clean-code
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.

Any agent
npx skills add SecondLifes/delphi-expert --skill clean-code
Clone the repo
git clone --depth 1 https://github.com/SecondLifes/delphi-expert

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 clean-code

README.md
[![agentmods](https://agentmods.dev/badge/skills/secondlifes/delphi-expert/clean-code/github.svg)](https://agentmods.dev/skills/secondlifes/delphi-expert/clean-code)
Your own site
<a href="https://agentmods.dev/skills/secondlifes/delphi-expert/clean-code"><img src="https://agentmods.dev/badge/skills/secondlifes/delphi-expert/clean-code/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for clean-code

Your own site · 80×15
<a href="https://agentmods.dev/skills/secondlifes/delphi-expert/clean-code"><img src="https://agentmods.dev/badge/skills/secondlifes/delphi-expert/clean-code.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 53 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,157 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 92% copy Near-identical to another mod 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.00053 $0.01157
Opus 5.5 $0.00021 $0.00463
Sonnet 5.5 $0.00011 $0.00231
Haiku 4.5 $0.00005 $0.00116

Measured 1mo ago against content hash f007b39a3fd8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

clean-code scanned grade A with 1 finding 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 1mo 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.

Strips warnings and disclaimerslowAnti-refusal

Omitting safety caveats hides risk from the user and is a common jailbreak preamble.

| ✅ **No errors?** | Compiles without warnings? |

Downgraded: this mod is about security review, or the phrase is quoted, so it is likely naming the pattern rather than instructing it.

Origin

This is a copy

92% identical to Delphi Clean Code — 8 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/clean-code/SKILL.md · 150 lines

How it starts

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

Delphi Clean Code — Skill

CRITICAL SKILL — Be concise, direct and solution-focused.

Fundamental Principles

Principle Rule
SRP A function/class does ONE thing
DRY Don't repeat code — extract and reuse
KISS Simplest solution that works
YAGNI Don't build what wasn't asked for
Boy Scout Leave the code better than you found it

Naming Rules (Pascal Guide)

Element Convention
Variables Reveal intent: LCustomerCount not N
Methods Verb + noun: GetCustomerById not Customer
Booleans Question form: IsActive, HasPermission, CanEdit
Constants SCREAMING_SNAKE: MAX_RETRY_COUNT
Fields Prefix F: FCustomerName
Parameters Prefix A: ACustomerName
Var. locations Prefix L: LCustomer

Rule: If you need a comment to explain a name, rename it.

Method Rules

Rule Description
Short Maximum 20 lines, ideal 5-10
One Thing Do one thing and do it well
One Level One level of abstraction per method
Few Args Maximum 3 arguments, prefer 0-2
No Side Effects Don't mute inputs unexpectedly

Code Structure

Standard Application
Guard Clauses Early returns for edge cases
Flat > Nested Avoid deep nesting (max 2 levels)
Composition Small compound methods
Colocation Related code together

Guard Clauses in Delphi

//❌ BAD — excessive nesting
procedure ProcessOrder(AOrder: TOrder);
begin
  if Assigned(AOrder) then
  begin
    if AOrder.Items.Count > 0 then
    begin
      if AOrder.IsValid then
      begin
        //real logic here
      end;
    end;
  end;
end;

//✅ GOOD — guard clauses
procedure ProcessOrder(AOrder: TOrder);
begin
  if not Assigned(AOrder) then
    raise EArgumentNilException.Create('AOrder cannot be nil');
  if AOrder.Items.Count = 0 then
    raise EBusinessRuleException.Create('Order must have items');
  if not AOrder.IsValid then
    raise EValidationException.Create('Order validation failed');

  //real logic here — no nesting
end;

Read the full file on GitHub · 150 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. 1mo ago First seen · 150 lines · 53 tokens per session scan A f007b39a3fd8

Subscribe to this mod's changes

clean-code is a skill published in the GitHub repository SecondLifes/delphi-expert (3 stars, last pushed 1mo ago), licensed MIT. It adds 53 tokens to every session and 1,157 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 1 finding (strips warnings and disclaimers). It is 92% identical to Delphi Clean Code, differing in 8 lines, and is treated as a copy.

Related

Other skills, from other repositories

erlang-otp-behaviors

Use when oTP behaviors including genserver for stateful processes, genstatem for state machines, supervisors for fault tolerance, genevent for event handling, and building robust, production-ready Erlang applications with proven patterns.

benchflow-ai/skillsbench · 52 tokens

omh-rust

This is an OMH rust workflow skill, projected for Agent Skills hosts (Claude Code, Codex, Cursor, opencode, OpenClaw, pi).

rlaope/oh-my-hermes · 74 tokens

axiom-concurrency

Use when writing ANY async code, actors, or threads in an Apple-platform app, or seeing ANY concurrency error. Covers Swift 6 concurrency, @MainActor, Sendable, data races, async/await patterns.

CharlesWiltgen/Axiom · 49 tokens

haskell-pro

Expert Haskell engineer specializing in advanced type systems, pure functional design, and high-reliability software. Use PROACTIVELY for type-level programming, concurrency, and architecture guidance.

rmyndharis/antigravity-skills · 41 tokens

splitting-oversized-modules

Split an oversized Python module (a thousand-plus-line logic.py, models.py, api.py, or its test file) into a package of one module per concern, mechanically and provably without changing behavior. Use on a request to split / break up / decompose a god module or move functions out of one, once a human has agreed to…

PostHog/posthog · 197 tokens

migrate-better-result-3

Migrate a TypeScript codebase from better-result 2.x to 3.0. Use when upgrading better-result across the TaggedError syntax, removed Result serialization helpers, recovery inference, matching, or retry APIs.

dmmulroy/better-result · 52 tokens