SkillProof tested Claude skills

Codebase Design

Vocabulario compartido para diseñar módulos profundos: interfaces, puntos de unión, adaptadores, testabilidad

Por mxyhi · mxyhi/ok-skills

Probado · Funciona ★ 9.2/10

Codebase Design — Vocabulario compartido para diseñar módulos profundos: interfaces, puntos de unión, adaptadores, testabilidad

Qué hace

Una habilidad de vocabulario y principios para diseñar módulos profundos — mucho comportamiento detrás de una interfaz pequeña, colocada en un punto de unión limpio y probada a través de esa interfaz. Se activa cuando el usuario quiere diseñar o mejorar la interfaz de un módulo, decidir dónde va un punto de unión, clasificar dependencias para pruebas o hacer el código más testable. Dos archivos de soporte añaden un flujo de trabajo de profundización (categorías de dependencia, pruebas de 'reemplazar-no-superponer') y un proceso paralelo de subagente 'design it twice'.

Informe de la prueba

Todos los tres archivos obtenidos en bruto (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md todos HTTP 200); el frontmatter se analiza con name+description, sin scripts, sin problemas de seguridad. Ejecuté una tarea de diseño real en contexto — "design the interface for a rate-limiter guarding a third-party API" — produciendo un artefacto de línea base y un artefacto siguiendo la habilidad. Diferencia concreta: la línea base expuso una clase acoplada a Redis de 4 métodos (tryAcquire/getRemaining/reset/setLimit); la versión de la habilidad colapsó la superficie de llamada a un único punto de entrada guard(key, action), clasificó Redis como category-2 local-substitutable frente a la API de SMS como category-4 true-external, y aplicó "two adapters = real seam" para mantener el puerto de almacenamiento mientras ocultaba el reloj como un punto de unión interno. El cuerpo de la habilidad reformó el diseño de manera medible en lugar de solo ser citado.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/mxyhi/ok-skills.git /tmp/codebase-design-src
mkdir -p ~/.claude/skills
cp -R /tmp/codebase-design-src/codebase-design ~/.claude/skills/codebase-design
# Pure markdown skill: SKILL.md + DEEPENING.md + DESIGN-IT-TWICE.md. No deps, scripts, or API keys.
# DESIGN-IT-TWICE.md references a project-local CONTEXT.md (your own domain vocab) which is not shipped and is optional.

Comandos y prompts de ejemplo

  • /codebase-designVocabulario compartido para diseñar módulos profundos: interfaces, puntos de unión, adaptadores, testabilidad

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Help me design a deeper interface for this module
  • Find deepening opportunities in this class
  • Decide where the seam should go in this code

Informe completo →