html-knowledge-base-templates: Instructions file for Claude Code

CLAUDE.md

Guidance for reviewing changes in this repo.

What this repo is

A collection of self-contained HTML knowledge-base template kits. Each kit pairs a template (the model's HTML target) with a skill (the slash command that fills it in), plus a working sample that demonstrates the loop.

The repo exists because good HTML knowledge templates — content-first, typographic, dependency-free, the equivalent of a well-typeset book chapter — are rare in the wild. Reviewers should keep that bar in mind. A kit that ships a landing-page-style template, or a skill that doesn't leverage model strengths, is technically valid but defeats the point.

Each top-level folder in the repo is one kit.

Standard kit layout

A kit must be drop-in usable on its own. The expected layout:

<kit-name>/
├── README.md              # what it does + how to run the demo
├── skills/
│   └── <verb>/SKILL.md    # one folder per slash command — a kit can ship multiple
├── template/
│   └── index.html         # HTML skeleton with {{placeholders}}
└── <data-dir>/            # inputs and outputs (e.g. podcast/transcripts, podcast/notes)

New kits should mirror this layout. If a new kit genuinely needs a different shape, update this file to reflect the new shared convention — do not diverge silently.

Creating a new kit

Pick the existing kit closest to what you want to build, copy its folder to <your-kit-name>/, then strip out the domain-specific content (sample data, kit-specific copy in README and SKILL.md) and fill in your own. Keep the standard layout above intact.

---

Review checklist

1. Required content is present

• An HTML template at template/index.html (or a clearly documented alternative)
• At least one processing skill under skills/<verb>/SKILL.md with frontmatter (name, description)
• A README.md that states what the kit produces and gives the exact command to run the demo
• A minimal working sample: one input file and one rendered output, so the demo runs end-to-end without extra setup