Design-pattern skills (moved to standalone repositories)

June 12, 2026 ยท View on GitHub

This directory previously hosted AKC's design-pattern skills: long-form "how" guidance paired 1:1 with the ADRs that motivate them. They are now published as standalone, installable skill repositories โ€” the same distribution model as the six cycle skills. The paired ADRs (the "why") remain in this repository.

SkillRepositoryPaired ADR(s)One-line summary
when-code-when-llmshimo4228/when-code-when-llmADR-0008Per-task decision: is this property structural or semantic?
code-and-llm-collaborationshimo4228/code-and-llm-collaborationADR-0008Per-pipeline decision: four layering patterns for mixing deterministic code and LLM calls
signal-first-researchshimo4228/signal-first-researchADR-0010Design a research intake filter that admits only information likely to change your next action

Installing

Each repository follows the standard Agent Skills layout (skills/<name>/SKILL.md):

# manual copy
cp -r skills/<skill-name> ~/.claude/skills/<skill-name>

# or via SkillsMP
/skills add shimo4228/<skill-name>

Why they moved

Hosting installable skills two levels deep under docs/ made them hard to discover and impossible to install with standard tooling. Moving each to its own repository matches the cycle-skill distribution model while the ADR pairing survives as cross-links: each skill's README and references section points back to its ADR here, and the table above points forward.