refactor-generalization

refactor-generalization is a skill for Claude Code, Codex from mickeyyaya/refactoring-skills. It costs 41 tokens per session (2,390 once invoked), scanned A, original, MIT.

A set of techniques for organizing inheritance hierarchies, where related classes share behavior through parent and child relationships. It helps decide what belongs in a shared parent, a child class, or a separate delegated object.

In plain words
What is it for?
Use it to move shared fields or methods up, move specialized behavior down, extract common interfaces, and replace inheritance with delegation when that better fits the design.
Why use it?
It addresses duplicated behavior between related classes and inheritance structures that are too broad, too deep, or used only for code reuse. The aim is to share common code without adding unnecessary structure.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to move shared fields or methods up, move specialized behavior down, extract common interfaces, and replace inheritance with delegation when that better fits the design.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mickeyyaya/refactoring-skills/refactor-generalization
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 mickeyyaya/refactoring-skills --skill refactor-generalization
Clone the repo
git clone --depth 1 https://github.com/mickeyyaya/refactoring-skills

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 refactor-generalization

README.md
[![agentmods](https://agentmods.dev/badge/skills/mickeyyaya/refactoring-skills/refactor-generalization.svg)](https://agentmods.dev/skills/mickeyyaya/refactoring-skills/refactor-generalization)
Your own site
<a href="https://agentmods.dev/skills/mickeyyaya/refactoring-skills/refactor-generalization"><img src="https://agentmods.dev/badge/skills/mickeyyaya/refactoring-skills/refactor-generalization.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,390 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.00041 $0.02390
Opus 5 $0.00020 $0.01195
Sonnet 5 $0.00008 $0.00478
Haiku 4.5 $0.00004 $0.00239

Measured 7d ago against content hash 4477c463c35e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

refactor-generalization 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 7d 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.

skills/refactor-generalization/SKILL.md · 357 lines

How it starts

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

Refactor: Dealing with Generalization

Overview

These 12 techniques manage inheritance hierarchies — pulling shared behavior up, pushing specific behavior down, extracting common interfaces, and replacing inheritance with delegation (or vice versa). Correct generalization prevents code duplication across subclasses while avoiding over-engineering.

When to Use

  • Sibling classes share duplicate methods or fields
  • Subclass only uses a fraction of parent's interface (Refused Bequest)
  • Adding a subclass in one hierarchy requires adding one in another (Parallel Inheritance)
  • Abstract class has only one concrete subclass (Speculative Generality)
  • Inheritance used for code reuse rather than true is-a relationships

Quick Reference

Technique Problem Solution
Pull Up Field Duplicate field in siblings Move to superclass
Pull Up Method Duplicate method in siblings Move to superclass
Pull Up Constructor Body Duplicate constructor code Move shared init to super constructor
Push Down Method Method only relevant to one subclass Move from parent to subclass
Push Down Field Field only used by one subclass Move from parent to subclass
Extract Subclass Features used only in some instances Create subclass for special case
Extract Superclass Two classes with similar features Create parent with shared features
Extract Interface Classes share partial interface Create interface for shared protocol
Collapse Hierarchy Subclass too similar to parent Merge subclass into parent
Form Template Method Same steps, different details Template in parent, steps in subclasses
Replace Inheritance with Delegation is-a doesn't hold Hold parent as field, delegate
Replace Delegation with Inheritance Delegates most calls, truly a subtype Use inheritance instead

Techniques in Detail

1. Pull Up Field / Pull Up Method

Before:

class Salesman {
  readonly name: string;
}

class Engineer {
  readonly name: string;
}

Read the full file on GitHub · 357 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. 7d ago First seen · 357 lines · 41 tokens per session scan A 4477c463c35e

Subscribe to this mod's changes

refactor-generalization is a skill published in the GitHub repository mickeyyaya/refactoring-skills (6 stars, last pushed 5mo ago), licensed MIT. It adds 41 tokens to every session and 2,390 once invoked, about $0.0002 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.