codebase-cleanup-refactor-clean

codebase-cleanup-refactor-clean is a skill for Claude Code, Codex from frogobox/frogo-sdk. It costs 51 tokens per session (439 once invoked), scanned A, original, Apache-2.0.

A guide for improving existing code using clean-code practices and common software design principles.

In plain words
What is it for?
It supports finding risky refactoring targets, making changes in small steps, and checking them with tests and regression checks.
Why use it?
It helps reduce duplication, simplify complicated modules, and make a codebase easier to maintain without changing it blindly.

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/frogobox/frogo-sdk/codebase-cleanup-refactor-clean
Any agent
npx skills add frogobox/frogo-sdk --skill codebase-cleanup-refactor-clean
Clone the repo
git clone --depth 1 https://github.com/frogobox/frogo-sdk

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 codebase-cleanup-refactor-clean

README.md
[![agentmods](https://agentmods.dev/badge/skills/frogobox/frogo-sdk/codebase-cleanup-refactor-clean.svg)](https://agentmods.dev/skills/frogobox/frogo-sdk/codebase-cleanup-refactor-clean)
Your own site
<a href="https://agentmods.dev/skills/frogobox/frogo-sdk/codebase-cleanup-refactor-clean"><img src="https://agentmods.dev/badge/skills/frogobox/frogo-sdk/codebase-cleanup-refactor-clean.svg" alt="Measured on agentmods" height="20"></a>
Per session 51 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 439 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.00051 $0.00439
Opus 5 $0.00026 $0.00219
Sonnet 5 $0.00010 $0.00088
Haiku 4.5 $0.00005 $0.00044

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

Security

Grade A, and why

codebase-cleanup-refactor-clean 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 4d 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.

.agents/skills/codebase-cleanup-refactor-clean/SKILL.md · 60 lines

What it actually says

Refactor and Clean Code

You are a code refactoring expert specializing in clean code principles, SOLID design patterns, and modern software engineering best practices. Analyze and refactor the provided code to improve its quality, maintainability, and performance.

Use this skill when

  • Cleaning up large codebases with accumulated debt
  • Removing duplication and simplifying modules
  • Preparing a codebase for new feature work
  • Aligning implementation with clean code standards

Do not use this skill when

  • You only need a tiny targeted fix
  • Refactoring is blocked by policy or deadlines
  • The request is documentation-only

Context

The user needs help refactoring code to make it cleaner, more maintainable, and aligned with best practices. Focus on practical improvements that enhance code quality without over-engineering.

Requirements

$ARGUMENTS

Instructions

  • Identify high-impact refactor candidates and risks.
  • Break work into small, testable steps.
  • Apply changes with a focus on readability and stability.
  • Validate with tests and targeted regression checks.
  • If detailed patterns are required, open resources/implementation-playbook.md.

Safety

  • Avoid large rewrites without agreement on scope.
  • Keep changes reviewable and reversible.

Output Format

  • Cleanup plan with prioritized steps
  • Key refactor targets and rationale
  • Expected impact and risk notes
  • Test/verification plan

Resources

  • resources/implementation-playbook.md for detailed patterns and examples.

Limitations

  • Use this skill only when the task clearly matches the scope described above.
  • Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
  • Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
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. 4d ago First seen · 60 lines · 51 tokens per session scan A d93b54d154ec

Subscribe to this mod's changes

codebase-cleanup-refactor-clean is a skill published in the GitHub repository frogobox/frogo-sdk (21 stars, last pushed yesterday), licensed Apache-2.0. It adds 51 tokens to every session and 439 once invoked, about $0.0003 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-30.

Related

Other skills, from other repositories

evergreen

Evergreen CI infrastructure, configuration validation. Use when modifying .evergreen/ config, preparing to submit changes or understanding the Evergreen test matrix.

mongodb/mongo-java-driver · 31 tokens

desktop-expert

Compose Multiplatform Desktop patterns for the desktopApp/ module. Use when working with (1) Desktop-only APIs (Window, WindowState, Tray, MenuBar, Dialog), (2) keyboard shortcuts and menu systems with OS-aware conventions (Cmd vs Ctrl, isMacOS branching), (3) desktop navigation (NavigationRail/sidebar vs Android…

vitorpamplona/amethyst · 157 tokens

gradle-expert

Build optimization, dependency resolution, and multi-module KMP troubleshooting for AmethystMultiplatform. Use when working with: (1) Gradle build files (build.gradle.kts, settings.gradle), (2) Version catalog (libs.versions.toml), (3) Build errors and dependency conflicts, (4) Module dependencies and source sets, (5)…

vitorpamplona/amethyst · 0 tokens

amy-expert

Patterns for extending amy, the Amethyst CLI in cli/. Use when adding an amy command, touching files under cli/src/main/kotlin/…/cli/, wiring a new subcommand into Main.kt, writing an interop test script that drives Amy, or extracting logic out of amethyst/ into commons/ so a CLI command can call it. Enforces the…

vitorpamplona/amethyst · 217 tokens

nip85-trusted-assertions

The NIP-85 trusted-assertions model in Quartz (nip85TrustedAssertions/) — kind 10040 trust-provider lists, kind 30382 contact cards / user assertions, 30383 event assertions, 30384 addressable assertions, 30385 external-id assertions. Use when building or parsing these events, working with the typed tags (RankTag…

vitorpamplona/amethyst · 148 tokens

compose-side-effects

Use when writing or reviewing Jetpack Compose code with LaunchedEffect, DisposableEffect, SideEffect, rememberCoroutineScope, rememberUpdatedState, snapshotFlow, snackbar, navigation, focus requests, analytics, or event Flow collection. Technique-layer skill — complements the codebase-specific compose-expert.

vitorpamplona/amethyst · 62 tokens