Architecture-Zoo Skill
Purpose
This skill turns a medical-imaging research question into a paper-grounded architecture choice —
so the build starts from the right archetype (and a known validation setup) rather than from whatever is
fashionable, and the choice carries its source citation into the Methods. It is the front end of the
model-engineering lane: architecture-zoo (choose) → /model-scaffold (build) → /model-validation (validate).
It is advisory (Layer D): it writes a short decision note, never code or weights. The actual repo is
/model-scaffold. It describes archetypes and the task → family → constraint logic, not a live SOTA
leaderboard (SOTA churns; the logic does not).
When to use
- You need to pick an architecture/backbone for a classification, segmentation, detection, or
transfer-learning question and want it grounded in the literature with a sensible default.
When NOT to use
- Generating the runnable repo →
/model-scaffold.
- Auditing a trained model's validation design →
/model-validation.
- Metrics / calibration →
/model-evaluation + /analyze-stats.
- General study/validity design →
/design-study; AI-vs-expert benchmark → /design-ai-benchmarking.
- LLM / MLLM →
/mllm-eval.
Workflow
Phase 1 — Frame the question
State the task (classification / segmentation / detection / transfer), the modality +
dimensionality (2-D vs 3-D volume), the labelled-data scale (events / structures, not just
images), label availability (lots / few / unlabelled pool), and constraints (class imbalance,
small structures, interpretability, deployment compute).
Phase 2 — Walk the decision tree
Open ${CLAUDE_SKILL_DIR}/references/index.md and follow task → constraints → default pick. It routes to
a family card.
Phase 3 — Read the family card
${CLAUDE_SKILL_DIR}/references/classification.md — ResNet / DenseNet / EfficientNet / Inception /
ViT / Swin / DeiT.
${CLAUDE_SKILL_DIR}/references/segmentation.md — U-Net / 3-D U-Net / V-Net / Attention & Residual
U-Net / nnU-Net / SegResNet / Swin-UNETR / Mask R-CNN.
${CLAUDE_SKILL_DIR}/references/detection.md — R-CNN family / Faster R-CNN + FPN / Mask R-CNN /
RetinaNet / YOLO / DETR.
${CLAUDE_SKILL_DIR}/references/synthesis.md — Pix2Pix / CycleGAN / SPADE / diffusion (DDPM, latent) /
VAE / fastMRI reconstruction.
${CLAUDE_SKILL_DIR}/references/foundation_models.md — SAM / MedSAM / MedSAM2 / TotalSegmentator /
SegVol / BiomedCLIP / DINO / MAE / SimCLR / MoCo.
${CLAUDE_SKILL_DIR}/references/graph.md — GCN / GraphSAGE / GAT / GIN / BrainGNN for brain
connectomes & population graphs (integrate PyTorch Geometric / DGL; not scaffolded by model-scaffold).
Each card gives the paper, core idea, when-to-use, medical-imaging use, reference implementation, and the
typical validation/experiment setup for that architecture class.
Phase 4 — Write the decision note
Record decisions/architecture_choice.md: the task, the chosen architecture, its source
paper, the reason against the constraints, the runner-up + why not, and the matching
/model-scaffold template. Naming the source paper is mandatory; cite, never invent, any benchmark
number.
Phase 5 — Hand off
Carry the decision note to /model-scaffold (instantiate the template), then /model-validation
(split / validation design), /model-evaluation + /analyze-stats (metrics), and /write-paper
(the Methods cite the architecture's source paper).
Anti-Hallucination
- Never recommend an architecture without naming its source paper. Every card cites the paper; the
decision note must carry that citation.
- Never invent benchmark numbers or paper claims. If a number matters, cite it (verify via
/search-lit); if uncertain, write [VERIFY] and ask.
- Never recommend an architecture for a modality or data scale it does not suit (e.g. a from-scratch
ViT on a few hundred images, or 2-D slices for a volumetric structure) — the constraints in the
decision tree exist to prevent exactly that.
- The zoo is a curated archetype map, not a current SOTA ranking — say so rather than implying a
recommendation is the latest best.
Boundaries
architecture-zoo (this skill: choose, paper-grounded)
└─ model-scaffold (build the reproducible repo from the chosen template)
└─ model-validation -> model-evaluation -> write-paper (cite the source paper)
It does not build, train, evaluate, or rank live SOTA — it maps the research question to a defensible,
paper-grounded archetype and hands the choice to /model-scaffold.
1---2name: architecture-zoo3description: >4 Choose a model architecture for a medical-imaging research question before scaffolding. Maps the task5 (classification, segmentation, detection, transfer), modality and dimensionality, labelled-data scale,6 and class imbalance to a shortlist of architectures, each grounded in its source paper with a7 when-to-use, a medical-imaging use, a reference implementation, the typical validation setup, and the8 matching model-scaffold template. Covers the foundational curriculum (ResNet, DenseNet, EfficientNet,9 ViT, Swin; U-Net, 3-D U-Net, Attention/Residual U-Net, nnU-Net (+ ResEnc/MedNeXt/STU-Net), Mask R-CNN;10 SAM/MedSAM, nnInteractive/VISTA3D interactive-3D, TotalSegmentator, BiomedCLIP, DINO/MAE/SimCLR; and11 graph neural nets — GCN/GraphSAGE/GAT/GIN/BrainGNN — for brain connectomes). It teaches archetypes and12 the task-to-architecture logic (including the "scale the CNN, new≠better" rigour caveat), not a live13 SOTA leaderboard.14triggers: architecture zoo, which architecture, choose a model, model selection, ResNet vs ViT, U-Net vs nnU-Net, what backbone, foundation model for, transfer learning choice, MedSAM, TotalSegmentator, DINO, MAE, self-supervised, graph neural network, GNN, brain connectome, GCN, GAT, GraphSAGE, BrainGNN, population graph, paper to architecture, reference implementation, when to use ViT, segmentation architecture, classification backbone, nnU-Net ResEnc, MedNeXt, STU-Net, nnInteractive, VISTA3D, SAM-Med3D, Mamba, U-Mamba, interactive segmentation, labelling acceleration, promptable segmentation, nnDetection, lesion detection, ConvNeXt, YOLO, YOLOv8, RT-DETR, DETR, RetinaNet, detection architecture, RETFound, UNI, CONCH, RAD-DINO, Merlin, medical foundation model, pathology foundation model, domain transfer, diffusion model, latent diffusion, ControlNet, MAISI, image synthesis, GAN, CycleGAN, Pix2Pix15tools: Read, Write, Edit, Grep, Glob16model: inherit17metadata:18 source: https://skillmd.com/skills/aperivue/architecture-zoo19---2021# Architecture-Zoo Skill2223## Purpose2425This skill turns a **medical-imaging research question into a paper-grounded architecture choice** —26so the build starts from the right archetype (and a known validation setup) rather than from whatever is27fashionable, and the choice carries its source citation into the Methods. It is the **front end** of the28model-engineering lane: `architecture-zoo (choose)` → `/model-scaffold (build)` → `/model-validation29(validate)`.3031It is **advisory** (Layer D): it writes a short decision note, never code or weights. The actual repo is32`/model-scaffold`. It describes **archetypes and the task → family → constraint logic**, not a live SOTA33leaderboard (SOTA churns; the logic does not).3435## When to use36- You need to pick an architecture/backbone for a classification, segmentation, detection, or37 transfer-learning question and want it grounded in the literature with a sensible default.3839## When NOT to use40- Generating the runnable repo → `/model-scaffold`.41- Auditing a trained model's validation design → `/model-validation`.42- Metrics / calibration → `/model-evaluation` + `/analyze-stats`.43- General study/validity design → `/design-study`; AI-vs-expert benchmark → `/design-ai-benchmarking`.44- LLM / MLLM → `/mllm-eval`.4546## Workflow4748### Phase 1 — Frame the question49State the **task** (classification / segmentation / detection / transfer), the **modality +50dimensionality** (2-D vs 3-D volume), the **labelled-data scale** (events / structures, not just51images), **label availability** (lots / few / unlabelled pool), and constraints (class imbalance,52small structures, interpretability, deployment compute).5354### Phase 2 — Walk the decision tree55Open `${CLAUDE_SKILL_DIR}/references/index.md` and follow task → constraints → default pick. It routes to56a family card.5758### Phase 3 — Read the family card59- `${CLAUDE_SKILL_DIR}/references/classification.md` — ResNet / DenseNet / EfficientNet / Inception /60 ViT / Swin / DeiT.61- `${CLAUDE_SKILL_DIR}/references/segmentation.md` — U-Net / 3-D U-Net / V-Net / Attention & Residual62 U-Net / nnU-Net / SegResNet / Swin-UNETR / Mask R-CNN.63- `${CLAUDE_SKILL_DIR}/references/detection.md` — R-CNN family / Faster R-CNN + FPN / Mask R-CNN /64 RetinaNet / YOLO / DETR.65- `${CLAUDE_SKILL_DIR}/references/synthesis.md` — Pix2Pix / CycleGAN / SPADE / diffusion (DDPM, latent) /66 VAE / fastMRI reconstruction.67- `${CLAUDE_SKILL_DIR}/references/foundation_models.md` — SAM / MedSAM / MedSAM2 / TotalSegmentator /68 SegVol / BiomedCLIP / DINO / MAE / SimCLR / MoCo.69- `${CLAUDE_SKILL_DIR}/references/graph.md` — GCN / GraphSAGE / GAT / GIN / BrainGNN for brain70 connectomes & population graphs (integrate PyTorch Geometric / DGL; not scaffolded by model-scaffold).71Each card gives the paper, core idea, when-to-use, medical-imaging use, reference implementation, and the72**typical validation/experiment setup** for that architecture class.7374### Phase 4 — Write the decision note75Record `decisions/architecture_choice.md`: the **task**, the **chosen architecture**, its **source76paper**, the **reason** against the constraints, the **runner-up + why not**, and the matching77**`/model-scaffold` template**. Naming the source paper is mandatory; cite, never invent, any benchmark78number.7980### Phase 5 — Hand off81Carry the decision note to `/model-scaffold` (instantiate the template), then `/model-validation`82(split / validation design), `/model-evaluation` + `/analyze-stats` (metrics), and `/write-paper`83(the Methods cite the architecture's source paper).8485## Anti-Hallucination8687- **Never recommend an architecture without naming its source paper.** Every card cites the paper; the88 decision note must carry that citation.89- **Never invent benchmark numbers or paper claims.** If a number matters, cite it (verify via90 `/search-lit`); if uncertain, write `[VERIFY]` and ask.91- **Never recommend an architecture for a modality or data scale it does not suit** (e.g. a from-scratch92 ViT on a few hundred images, or 2-D slices for a volumetric structure) — the constraints in the93 decision tree exist to prevent exactly that.94- The zoo is a curated **archetype** map, not a current SOTA ranking — say so rather than implying a95 recommendation is the latest best.9697## Boundaries9899```100architecture-zoo (this skill: choose, paper-grounded)101 └─ model-scaffold (build the reproducible repo from the chosen template)102 └─ model-validation -> model-evaluation -> write-paper (cite the source paper)103```104105It does not build, train, evaluate, or rank live SOTA — it maps the research question to a defensible,106paper-grounded archetype and hands the choice to `/model-scaffold`.