kolea: Skill for Claude Code

.claude/skills/solid-principles/SKILL.md

solid-principles is a skill for Claude Code from robconery/kolea. It costs 97 tokens per session (991 once invoked), scanned A, original, MIT.

A TypeScript guide to SOLID, five object-oriented design principles for organizing code into classes and modules. The principles aim to make changes safer and code easier to test.

In plain words
What is it for?
Use it when designing or refactoring classes, splitting responsibilities, introducing abstractions, or reviewing object-oriented code design.
Why use it?
It helps developers diagnose rigid, fragile, or tightly connected code before refactoring it. TypeScript is a programming language that adds type checking to JavaScript.

Skill for Claude Code

Written for Claude Code: installed under .claude/.

This is robconery/kolea's own configuration. It tells Claude Code how to work on kolea itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything kolea configures →

Reuse

Borrowing it

Nothing to install: this file belongs to robconery/kolea. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/robconery/kolea/main/.claude/skills/solid-principles/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/robconery/kolea

Made for: Claude Code.

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 solid-principles

README.md
[![agentmods](https://agentmods.dev/badge/skills/robconery/kolea/solid-principles/github.svg)](https://agentmods.dev/skills/robconery/kolea/solid-principles)
Your own site
<a href="https://agentmods.dev/skills/robconery/kolea/solid-principles"><img src="https://agentmods.dev/badge/skills/robconery/kolea/solid-principles/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 solid-principles

Your own site · 80×15
<a href="https://agentmods.dev/skills/robconery/kolea/solid-principles"><img src="https://agentmods.dev/badge/skills/robconery/kolea/solid-principles.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 97 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 991 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.00097 $0.00991
Opus 5.5 $0.00039 $0.00396
Sonnet 5.5 $0.00019 $0.00198
Haiku 4.5 $0.00010 $0.00099

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

Security

Grade A, and why

solid-principles 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 2mo 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.

Origin

Copies of this mod

2 near-identical copies found in the catalogue:

.claude/skills/solid-principles/SKILL.md · 83 lines

How it starts

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

SOLID Principles in TypeScript

Five principles of object-oriented design (Robert C. Martin) that keep code flexible, testable, and resistant to rot — adapted to idiomatic TypeScript, where interfaces, structural typing, union types, and plain functions often satisfy a principle without ceremony.

🎯 Why: Design for Change

The goal of writing software is to be able to change it safely. SOLID is the OO toolkit for that goal: SRP limits what changes when a reason to change appears, OCP lets you extend without editing tested code, LSP keeps substitutions safe, ISP keeps consumers from breaking on unrelated changes, DIP lets you swap implementations without rewriting policy. Every rule below earns its keep only if it shrinks the next diff.

How to use this skill

  1. Match the symptom in the decision guide below to a principle.
  2. Open references/principles.md for the full before/after TypeScript example and the "when this is over-engineering" note for that principle.
  3. Apply the smallest change that removes the actual pain. SOLID is a response to demonstrated change pressure, not a checklist to apply preemptively. A 30-line app does not need an interface per class.

Reference file

  • references/principles.md — all five principles (SRP, OCP, LSP, ISP, DIP) with motivation, a bad example, a refactor, TypeScript-specific notes, and when not to apply each.

The five principles

Letter Principle One-line intent
S Single Responsibility A class/module should have one reason to change.
O Open/Closed Open for extension, closed for modification.
L Liskov Substitution Subtypes must be usable wherever their base type is expected.
I Interface Segregation Many small client-specific interfaces beat one fat one.
D Dependency Inversion Depend on abstractions, not concretions.

Decision guide — symptom → principle

You notice… Apply Letter
A class changes for unrelated reasons (DB + formatting + business rules) Single Responsibility S
Adding a new "type" means editing a growing switch/if-else Open/Closed O
A subclass throws on, no-ops, or weakens a method it inherited Liskov Substitution L
Implementers are forced to stub methods they don't use Interface Segregation I
Business logic imports a concrete DB/HTTP/SDK client directly Dependency Inversion D
Unit tests need a real database, network, or clock Dependency Inversion D
One change ripples across many unrelated files Single Responsibility S
instanceof chains decide behavior Open/Closed (often Strategy/polymorphism) O

Read the full file on GitHub · 83 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 2mo ago First seen · 83 lines · 97 tokens per session scan A 8d5f21c036da

Subscribe to this mod's changes

solid-principles is a skill published in the GitHub repository robconery/kolea (11 stars, last pushed 28d ago), licensed MIT. It adds 97 tokens to every session and 991 once invoked, about $0.0004 per session on Opus 5.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

no-bare-casts

Writing as in TypeScript or TSX production code, modifying a file that contains a bare as cast, silencing a type error with a cast, encountering as unknown as, or reviewing a cast site.

prisma/orm · 52 tokens

supermemory

Supermemory is a state-of-the-art memory and context infrastructure for AI agents. Use this skill when building applications that need persistent memory, user personalization, long-term context retention, or semantic search across knowledge bases. It provides Memory API for learned user context, User Profiles for…

supermemoryai/supermemory · 81 tokens

coding-standards

Universal coding standards, best practices, and patterns for TypeScript, JavaScript, React, and Node.js development.

hashgraph-online/awesome-codex-plugins · 28 tokens

better-t-stack

Create or extend an end-to-end type-safe TypeScript project with Better-T-Stack (create-better-t-stack). Use when the user wants to start, scaffold or bootstrap an app, API, fullstack project or monorepo with any of Next.js, TanStack Router or Start, React Router, Nuxt, Svelte, Solid, Astro, React Native, Hono…

AmanVarshney01/create-better-t-stack · 149 tokens

drizzle-orm

Use when modeling data or querying with Drizzle ORM in TypeScript — pgTable schema in .ts, type-safe select/insert/relational queries, drizzle-kit migrations. NOT Prisma Client or schema.prisma (that is prisma-orm), NOT ORM-agnostic migration strategy (that is db-migrations), NOT Postgres engine tuning or EXPLAIN…

ericrisco/rsc-harness · 96 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