Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/emiliodominguez/flow-skills --skill flow-simplifyAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
Simplify
Subtract only where it improves understanding without changing required behavior. Fewer lines is a possible outcome, not the acceptance criterion.
Process
- Bound the cleanup, establish relevant checks and preserve unrelated staged/unstaged work.
Name the concrete complexity: dead paths, needless indirection, duplicate responsibility, stale comments or generated slop.
- Order reduction passes by semantic risk. For large scopes, authorized read-only reviewers can
inspect disjoint areas; one writer per file. No arbitrary agent or file-count threshold.
- Caller-check before deleting a symbol: imports, dynamic lookup, registries, reflection,
routes, config, templates, tests, generated sources, package exports. Repository search cannot see external consumers of a published API.
- Mark a deletion CONFIRMED-DEAD only with usage and runtime evidence; keep uncertain
exports or negotiate the compatibility change. Keep side-effect imports (registration, polyfills) and license, compiler and tool-directive comments.
- Inspect single-use abstractions instead of auto-inlining. Components, Hooks, closures and
effects carry identity, state lifetime and evaluation order even with one caller.
- Remove a defensive guard only when input provenance proves it redundant. Static types do not
validate network, JSON, storage, DOM or JavaScript consumers.
- Cut in small steps, run behavior and repository checks, inspect the combined diff. Stop when
the stated complexity is resolved.
Anti-patterns
- Net-negative lines as a quality gate, or every single-use component as waste.
- Removing imports, comments or guards on regex or type evidence alone.
- Deleting a public export because internal grep finds no caller.
- Quietly changing error behavior or component state lifetime.
Done when
- The targeted code is easier to understand with semantics and compatibility preserved.
- Deletions have evidence; uncertain consumers remain explicit.
- Required checks ran on the resulting artifact, not an earlier baseline.
Use flow-review for the diff or flow-refactor for a separate ownership or structure problem.
