SkillProof tested Claude skills

Codebase Design

Gemeinsames Vokabular für das Design tiefer Module: Schnittstellen, Nahtstellen, Adapter, Testbarkeit

von mxyhi · mxyhi/ok-skills

Getestet · Funktioniert ★ 9.2/10

Codebase Design — Gemeinsames Vokabular für das Design tiefer Module: Schnittstellen, Nahtstellen, Adapter, Testbarkeit

Was es kann

Eine Vokabular- und Prinzipien-Fähigkeit für das Design tiefer Module – viel Verhalten hinter einer kleinen Schnittstelle, platziert an einer sauberen Nahtstelle und über diese Schnittstelle getestet. Sie wird ausgelöst, wenn der Benutzer die Schnittstelle eines Moduls entwerfen oder verbessern, entscheiden möchte, wo eine Nahtstelle platziert wird, Abhängigkeiten für Tests klassifizieren oder Code testbarer machen möchte. Zwei unterstützende Dateien ergänzen einen Vertiefungs-Workflow (dependency categories, replace-don't-layer testing) und einen parallelen Sub-Agenten-"design it twice"-Prozess.

Testbericht

Alle drei Dateien roh abgerufen (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md alle HTTP 200); Frontmatter wird mit name+description geparst, keine Skripte, keine Sicherheitsmängel. Eine reale Designaufgabe im Kontext ausgeführt – "design the interface for a rate-limiter guarding a third-party API" – und ein Baseline-Artefakt sowie ein Skill-konformes Artefakt erstellt. Konkreter Unterschied: Die Baseline legte eine Redis-gekoppelte Klasse mit 4 Methoden offen (tryAcquire/getRemaining/reset/setLimit); die Skill-Version reduzierte die Aufrufoberfläche auf einen guard(key, action) Einstiegspunkt, klassifizierte Redis als category-2 local-substitutable gegenüber der SMS API als category-4 true-external und wendete "two adapters = real seam" an, um den Speicherport zu erhalten, während die Uhr als interne Nahtstelle verborgen wurde. Der Skill-Inhalt hat das Design messbar umgestaltet, anstatt nur zitiert zu werden.

Getestet am: 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.

Befehle & Beispiel-Prompts

  • /codebase-designGemeinsames Vokabular für das Design tiefer Module: Schnittstellen, Nahtstellen, Adapter, Testbarkeit

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →