SkillProof tested Claude skills

Codebase Design

Vocabulaire partagé pour la conception de modules profonds : interfaces, points de jonction, adaptateurs, testabilité

par mxyhi · mxyhi/ok-skills

Testé · Fonctionne ★ 9.2/10

Codebase Design — Vocabulaire partagé pour la conception de modules profonds : interfaces, points de jonction, adaptateurs, testabilité

Ce que fait

Une compétence de vocabulaire et de principes pour la conception de modules profonds — beaucoup de comportement derrière une petite interface, placée à un point de jonction propre et testée via cette interface. Elle se déclenche lorsque l'utilisateur souhaite concevoir ou améliorer l'interface d'un module, décider où placer un point de jonction, classer les dépendances pour les tests, ou rendre le code plus testable. Deux fichiers de support ajoutent un workflow d'approfondissement (catégories de dépendances, tests 'replace-don't-layer') et un processus parallèle de sous-agent "design it twice".

Rapport de test

Les trois fichiers bruts (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md tous HTTP 200) ont été récupérés ; le frontmatter est analysé avec name+description, pas de scripts, pas de failles de sécurité. J'ai exécuté une tâche de conception réelle en contexte — "design the interface for a rate-limiter guarding a third-party API" — produisant un artefact de base et un artefact suivant la compétence. Différence concrète : la version de base exposait une classe Redis-couplée à 4 méthodes (tryAcquire/getRemaining/reset/setLimit) ; la version de la compétence a réduit la surface d'appel à un seul point d'entrée guard(key, action), a classifié Redis comme substituable local de catégorie 2 par rapport à l'API SMS comme externe véritable de catégorie 4, et a appliqué "two adapters = real seam" pour conserver le port de stockage tout en masquant l'horloge comme un point de jonction interne. Le corps de la compétence a remodelé la conception de manière mesurable plutôt que de simplement la citer.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Commandes et exemples de prompts

  • /codebase-designVocabulaire partagé pour la conception de modules profonds : interfaces, points de jonction, adaptateurs, testabilité

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →