Skill code-bloat-stinger
scriptsRealiza una auditoría de solo lectura de bases de código para medir la duplicación, el código no utilizado y el exceso estructural mediante diversas herramientas de análisis.
- Estrellas en GitHub
- 95
- Archivos
- 22
- Último commit
- 18 oct 2026
- Licencia
- AGPL-3.0-or-later
- Herramientas permitidas
- —
¿Qué hace la skill code-bloat-stinger?
Realiza una auditoría de solo lectura de bases de código para medir la duplicación, el código no utilizado y el exceso estructural mediante diversas herramientas de análisis.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill code-bloat-stinger
Medir la duplicación de código, el código no utilizado y el exceso estructural es lo que este SKILL permite hacer a desarrolladores y fundadores. Realiza una auditoría de solo lectura creando una copia temporal del repositorio, lo que garantiza que el código fuente original permanezca sin cambios. El proceso utiliza herramientas especializadas como jscpd para la detección de duplicación, knip para código no utilizado en JavaScript y TypeScript, y diversas herramientas específicas de cada lenguaje como vulture o cargo para otros entornos. También utiliza cloc o scc para el conteo de líneas y lizard para analizar la estructura de funciones y closures.
Un agente debe cargar este SKILL cuando se le asigne la tarea de cuantificar la deuda técnica o planificar la descomposición de archivos grandes. Produce métricas detalladas, hallazgos y planes de división, incluyendo un veredicto por bandas. El SKILL es compatible con Claude Code, Cursor, Codex y Cowork, y requiere Node 20.19 o superior y Python 3.9 o superior. Está diseñado específicamente para reportes y auditorías, no para realizar el refactorizado o la eliminación de código propiamente dicha.
Lo que un agente puede hacer con ella
- 1Cuantificar la duplicación de códigoDetermina qué parte de un repositorio consiste en código copiado y pegado utilizando tamaños de tokens específicos.
- 2Identificar código muertoEncuentra archivos, exports y dependencias no utilizados dentro de una base de código para estimar la proporción de código realmente muerto.
- 3Planificar la división de archivosAnaliza archivos grandes y funciones complejas para crear una estrategia de descomposición.
- 4Verificar el progreso de la limpiezaVuelve a ejecutar auditorías tras una fase de refactorización para proporcionar pruebas numéricas de las mejoras.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill code-bloat-stinger
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill code-bloat-stinger en Plugin
/plugin marketplace add legioncodeinc/vibe-coding-tools /plugin install code-audit-tools@wasp-nest
Instalar la skill code-bloat-stinger en Claude Code
~/.claude/skills/code-bloat-stinger/SKILL.md
$ npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger ~/.claude/skills/code-bloat-stingerInstalar la skill code-bloat-stinger en Claude Code (project)
.claude/skills/code-bloat-stinger/SKILL.md
$ npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger .claude/skills/code-bloat-stingerInstalar la skill code-bloat-stinger en Codex
~/.agents/skills/code-bloat-stinger/SKILL.md
$ npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger ~/.agents/skills/code-bloat-stingerInstalar la skill code-bloat-stinger en Gemini CLI
~/.gemini/skills/code-bloat-stinger/SKILL.md
$ npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger ~/.gemini/skills/code-bloat-stingerInstalar la skill code-bloat-stinger en Claude.ai
npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger code-bloat-stinger && zip -r code-bloat-stinger.zip code-bloat-stinger # claude.ai → Customize → Skills → + → Create skill → Upload a skill → code-bloat-stinger.zip
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún sin verificar. Una skill necesita 80 puntos, ningún hallazgo grave y datos suficientes para comprobarla. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblelegioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger is public and reachablegithub.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins ↗Aprobado
- Licencia de código abierto (OSI)AGPL-3.0-or-later is not OSI-approvedspdx.org/licenses/AGPL-3.0-or-later.html ↗Hallazgo
- Commit o lanzamiento en el último añoLast commit 2026-10-18github.com/legioncodeinc/vibe-coding-tools/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scripts5 of 6 scripts read; none of them downloads and runs code, the rest were not readHallazgo
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/legioncodeinc/vibe-coding-tools/blob/HEAD/plugins ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/legioncodeinc/vibe-coding-tools/blob/HEAD/plugins ↗Aprobado
- SKILL.md sigue el formato de Agent Skillsthe description does not say when to use the skillgithub.com/legioncodeinc/vibe-coding-tools/blob/HEAD/plugins ↗Hallazgo
SKILL.md
Ver en GitHubCode Bloat Stinger
Designed and built by Legion Code Inc.
Where this skill's files are
Every path below (guides/, references/, scripts/) is relative to the folder that contains this SKILL.md. In Claude Code that folder is ${CLAUDE_SKILL_DIR}. If that text was not replaced with a real path, find the folder yourself (Glob for **/code-bloat-stinger/SKILL.md) and use it as SKILL_DIR in every command.
Requirements
Node 20.19 or newer, Python 3.9 or newer, and Perl for cloc or a downloaded scc binary (Go or Cargo only for those repos). The commands in references/tool-commands.md are bash (env -i, bash arrays, [ ] tests): on Windows, run them in Git Bash or WSL, not PowerShell or cmd. The throwaway copy (audit-my-code-stinger/scripts/make_scratch_copy.py) and this skill's scripts/*.py are plain Python and run anywhere.
Purpose
Answer "how bloated is this codebase, and why?" with numbers a founder can trust. The skill measures three kinds of bloat separately, because they have different causes and fixes: copy-pasted code (jscpd at two clone sizes, with both the standard and the both-copies figure), unused code (knip for JS and TS, vulture, deadcode, staticcheck or cargo tools elsewhere, always checked by hand before it is called dead), and shape (share of code in files over 1,000 lines, the largest functions, factory closures, and a split plan). It writes the bloat dimension of an Audit My Code run (01-bloat/) under the shared contract, and never changes the audited repository: every tool runs in a throwaway copy that is removed afterwards. The method reproduces a hand-run reference audit (WHIPT, 2026-09-30) on any repository.
When to use
- "Is this codebase bloated?", "is it bloated because it was vibe coded?", "how much is copy-pasted?", "how much dead code is there?"
- The
bloatdimension of/audit-my-codeat thevibe,basic,full, ormariotier - Measuring duplication, unused files, exports and dependencies, file and function size, or planning how to split giant files
- Re-running the same measures after a cleanup to show what changed
When not to use
- Security weaknesses:
security-stingerand the framework security Drones (02-security/) - Whether the code matches its plan, tests, or quality bar:
quality-stinger(03-quality/) - Repo setup, CI, docs, and hygiene: the foundation Drone (
00-foundation/) - Actually deleting code or refactoring: this skill only reports; remediation belongs to the
mariotier and the owning engineering Drone - Dependency vulnerability triage:
dependency-audit-stinger
Procedure
- Read
guides/00-scoping-and-throwaway-copy.md. Readintake.json, make the copy withgit archive, install pinned tools outside the copy, write the scope and file list, capturegit statusof the audited repo, pick the language route. - Run duplication per
guides/01-duplication-with-jscpd.md: 50 and 100 tokens, size and line caps lifted, scan coverage checked against the file list, thenscripts/jscpd_recount.pyfor both copies, per area, big versus small files, and top pairs. - Run unused-code detection per
guides/02-unused-code-with-knip.md: workspace-aware knip from outside the repo, a failing plugin disabled through an external config, a production-mode second view, thenscripts/knip_summarize.py. For non-JS code use the tools inreferences/non-js-dead-code.md. - Count lines per
guides/03-size-and-line-counts.mdwith cloc (--skip-uniqueness) or scc, thenscripts/size_profile.py. - Measure structure per
guides/04-structure-and-split-planning.mdwith lizard andscripts/function_profile.py; read the largest files and write the split plan, including the context-object step for closures. - Spot-check per
guides/05-spot-check-and-false-positives.md: at least 12 flagged items classified Dead, False alarm, or Partial with a reason, then the truly-dead estimate as a share of core code lines. - Band, set the verdict, write the verdict paragraph, and write
metrics.json,findings.jsonl, andnotes.mdperguides/06-bands-verdict-and-contract-output.md. List raw artifacts under## Evidenceinnotes.md(the orchestrator buildsevidence-index.md). Runscripts/validate_outputs.pyand fix every error. - Confirm the audited repo is unchanged, remove
.scratch/, and report to the orchestrator: verdict, headline measures, caps lifted, and anything not run.
References map
| Path | Load when |
|---|---|
guides/00-scoping-and-throwaway-copy.md |
Always first |
guides/01-duplication-with-jscpd.md |
Running or reading jscpd |
guides/02-unused-code-with-knip.md |
Running knip or a language dead-code tool |
guides/03-size-and-line-counts.md |
Counting lines, big-file share |
guides/04-structure-and-split-planning.md |
Largest functions, closures, split plans |
guides/05-spot-check-and-false-positives.md |
Before calling anything dead |
guides/06-bands-verdict-and-contract-output.md |
Banding, verdict paragraph, writing outputs |
references/tool-commands.md |
Any command line; pinned versions |
references/bands.md |
Banding a measure, choosing severity, setting the verdict |
references/false-positive-classes.md |
Classifying a flagged item |
references/non-js-dead-code.md |
Python, Go, Rust, or another language in scope |
references/output-templates.md |
Writing metrics.json, findings.jsonl, notes.md |
references/REFERENCE.md |
Script inputs and outputs; raw folder layout |
references/research/distilled-code-bloat.md |
Verifying a tool behavior or a band, settling a dispute |
| Source research archive (not shipped with the plugin) | Source-repository only; the shipped distillation summarizes it, do not require it |
scripts/*.py |
As each guide directs; every script has --help |
Related drones and stingers
- code-bloat-wasp-drone - The paired Drone; the orchestrator dispatches it for the
bloatdimension. - audit-my-code-stinger - The run contract and orchestration for
/audit-my-code. security-stinger- Security dimension; overlaps only where dead code hides a vulnerable path.quality-stinger- Quality dimension, run after security in thefullandmariotiers.dependency-audit-stinger- Vulnerable or outdated dependencies, as opposed to unused ones.
Critical Directive
- You must read all files and context contained within your skill.
- In the event your core knowledge does not provide sufficient guidance you must make every attempt to search the internet, related knowledge base documentation files, and other available resources to supplement your knowledge prior to proceeding with your task.
- Additional related skills can be found here:
- audit-my-code-stinger - Run contract, tiers, workspace layout, and the brief renderer for Audit My Code.
- webapp-capture-stinger - Code-level UI inconsistency audit, when bloat findings point at duplicated components.
Designed and built by Legion Code Inc. Licensed under AGPL-3.0-or-later.
Archivos de esta skill
22Preguntas sobre la skill code-bloat-stinger
¿Cómo instalo la skill code-bloat-stinger en Claude Code?
Ejecuta npx degit legioncodeinc/vibe-coding-tools/plugins/code-audit-tools/skills/code-bloat-stinger ~/.claude/skills/code-bloat-stinger. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill code-bloat-stinger?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Qué mide este SKILL?
Mide tres tipos de exceso: código copiado y pegado (duplicación), código no utilizado (dead code) y estructura (tamaño y forma de archivos y funciones).
¿Este SKILL modifica mi repositorio?
No, el SKILL es de solo lectura y ejecuta todas las herramientas dentro de una copia temporal que se elimina tras la auditoría.
¿Cuáles son los requisitos del sistema para este SKILL?
Requiere Node 20.19 o superior, Python 3.9 o superior, y ya sea Perl para cloc o un binario de scc descargado.