SkillProof tested Claude skills

Codebase Design

Delat ordförråd för att designa djupa moduler: gränssnitt, sömmar, adaptrar, testbarhet

av mxyhi · mxyhi/ok-skills

Testad · Fungerar ★ 9.2/10

Codebase Design — Delat ordförråd för att designa djupa moduler: gränssnitt, sömmar, adaptrar, testbarhet

Vad den gör

En färdighet för ordförråd och principer för att designa djupa moduler – mycket beteende bakom ett litet gränssnitt, placerat vid en ren söm och testat genom det gränssnittet. Den utlöses när användaren vill designa eller förbättra en moduls gränssnitt, bestämma var en söm ska placeras, klassificera beroenden för testning, eller göra kod mer testbar. Två stödjande filer lägger till ett fördjupande arbetsflöde (beroendekategorier, replace-don't-layer-testning) och en parallell sub-agent "design it twice"-process.

Testrapport

Hämtade alla tre filer råa (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md alla HTTP 200); frontmatter parsas med name+description, inga skript, inga säkerhetsbrister. Körde en verklig designuppgift i sammanhanget — "designa gränssnittet för en rate-limiter som skyddar ett tredjeparts-API" — producerade en baslinjeartefakt och en färdighetsföljande artefakt. Konkret skillnad: baslinjen exponerade en 4-metoders Redis-kopplad klass (tryAcquire/getRemaining/reset/setLimit); färdighetsversionen kollapsade anropsytan till en guard(key, action) ingångspunkt, klassificerade Redis som kategori-2 lokalt utbytbar kontra SMS API som kategori-4 sant extern, och tillämpade "två adaptrar = verklig söm" för att behålla lagringsporten samtidigt som klockan dolts som en intern söm. Färdighetens kropp omformade designen mätbart snarare än att bara citeras tillbaka.

Testad: 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.

Kommandon och exempelprompter

  • /codebase-designDelat ordförråd för att designa djupa moduler: gränssnitt, sömmar, adaptrar, testbarhet

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →