code-refactor

A code-refactoring guide focused on clean architecture, SOLID design principles, strict TypeScript interfaces, and avoiding barrel imports, which re-export code through a central file.

In plain words
What is it for?
Use it when reorganizing TypeScript code, improving module boundaries, or applying clean-architecture and SOLID rules.
Why use it?
It helps make code easier to maintain by enforcing consistent structure and reducing unclear dependencies between modules.

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/cardsorting/lumi-joy/code-refactor
Any agent
npx skills add CardSorting/LUMI-JOY --skill code-refactor
Clone the repo
git clone --depth 1 https://github.com/CardSorting/LUMI-JOY

Made for: Claude Code, Codex.

Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 143 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 $0.00024 $0.00143
Opus 5 $0.00012 $0.00072
Sonnet 5 $0.00005 $0.00029
Haiku 4.5 $0.00002 $0.00014

Measured yesterday against content hash 04f9204c244a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

code-refactor 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 yesterday.

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/code-refactor/SKILL.md · 20 lines

What it actually says

Code Refactor Specialist

Clean architecture refactoring specialist enforcing SOLID principles, strict TypeScript interfaces, and zero barrel imports.

📋 Execution Protocol

  1. Analyze Input: Validate preconditions and inspect operational context.
  2. Execute Actions: Carry out procedures using deterministic tools.
  3. Verify Outcome: Assert correctness and log diagnostic telemetry.

🛡️ Operational Guardrails & Rules

  • Execute with deterministic consistency and verify outputs.
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. yesterday First seen · 20 lines · 24 tokens per session scan A 04f9204c244a

Subscribe to this mod's changes

code-refactor is a skill published in the GitHub repository CardSorting/LUMI-JOY (2 stars, last pushed 4d ago), licensed Apache-2.0. It adds 24 tokens to every session and 143 once invoked, about $0.0001 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

code-to-diagram

Analyze codebases and automatically generate architecture diagrams, flowcharts, and org charts. Uses AST parsing to map import dependencies for Python, JS/TS, Go, and Java, outputting Mermaid or SVG files. Triggered when users ask to visualize code architecture, understand dependencies, draw a flowchart, or create a…

zebbern/claude-code-guide · 74 tokens

swapper-deposit

Deposit and bridge funds into a wallet or protocol using Swapper Finance. Handles fiat on-ramp (card payments via Mastercard, Visa, Apple Pay, Google Pay), crypto transfers, and cross-chain bridging via Chainlink CCIP — directly into lending, staking, and liquidity protocols. Supports Ethereum, Base, Arbitrum…

swapperfinance/swapper-toolkit · 158 tokens

Planner

Breaks down complex tasks into ordered, verifiable sub-tasks with dependencies, milestones, and risks.

Tariux/AI-Skills-Not-Awesome · 23 tokens

code-review

AI-powered code review and PR analysis. Performs systematic reviews covering security vulnerabilities, code quality, style compliance, architectural integrity, test coverage, and performance considerations. Works with PR diffs, commit ranges, file changes, or raw code snippets. Primary keyword clusters: AI code review…

JPeetz/agent-skills · 137 tokens

sast-fileupload

Detect insecure file upload vulnerabilities in a codebase using a three-phase approach: discovery (find all upload sites), batched verify (check extension bypass and related issues in parallel subagents, 3 sites each), and merge (consolidate batch results). Requires sast/architecture.md (run sast-analysis first).…

capture0x/YeepForge · 92 tokens

sast-jwt

Detect insecure JWT (JSON Web Token) implementations in a codebase using a two-phase approach: first map all JWT issuance and verification sites to understand the token lifecycle and signing configuration, then check each verification site for exploitable weaknesses such as algorithm confusion, missing signature…

capture0x/YeepForge · 123 tokens