Skip to content

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

CSS

refcheck refuses a frontmatter that breaks installers; the recipes count nine

Youssef7eeeaf61730a
diff --git a/docs/recipes.md b/docs/recipes.md
index df7dc1e..a4351cf 100644
--- a/docs/recipes.md
+++ b/docs/recipes.md
@@ -1,6 +1,6 @@
# Recipes
-Eight briefs you can paste into Claude Code, Codex CLI or OpenCode with Hallmark installed. Each is the prompt verbatim and what the skill is expected to infer; the picks are not fixed, because the theme deal rotates against the project's log and two runs of the same brief should not land on the same shape or theme. The rendered pages under [`site/_tests/`](../site/_tests/) were built from these prompts by an earlier version of the skill and predate the v2 gates.
+Nine briefs you can paste into Claude Code, Codex CLI or OpenCode with Hallmark installed. Each is the prompt verbatim and what the skill is expected to infer; the picks are not fixed, because the theme deal rotates against the project's log and two runs of the same brief should not land on the same shape or theme. The rendered pages under [`site/_tests/`](../site/_tests/) were built from these prompts by an earlier version of the skill and predate the v2 gates.
The first recipe is the one to try in a fresh project to see the flow before reading anything else.
diff --git a/skills/hallmark/scripts/refcheck.mjs b/skills/hallmark/scripts/refcheck.mjs
index bf9c0a9..e10b362 100644
--- a/skills/hallmark/scripts/refcheck.mjs
+++ b/skills/hallmark/scripts/refcheck.mjs
@@ -255,6 +255,10 @@ for (const f of [...reach]) {
for (const f of MD) if (!reach.has(f) && basename(f) !== 'README.md') add('warn', f, 1, 'orphan', 'no file reachable from SKILL.md names this file');
const skillBytes = Buffer.byteLength(read(SKILL));
+const front = /^---\n([\s\S]*?)\n---\n/.exec(readFileSync(SKILL, 'utf8'));
+const fm = front ? Object.fromEntries(front[1].split('\n').map((l) => /^([a-z-]+):\s*(.*)$/.exec(l)).filter(Boolean).map((m) => [m[1], m[2]])) : {};
+if (!fm.name || !fm.description) add('error', SKILL, 1, 'frontmatter', 'SKILL.md needs name and description in its frontmatter, or installers find no skill');
+else if (!/^"(?:[^"\\]|\\.)*"$/.test(fm.description) || fm.description.length > 1026) add('error', SKILL, 2, 'frontmatter', 'the description must be one double-quoted line of 1,024 characters or fewer; an unquoted colon breaks strict YAML parsers');
if (skillBytes > 19000) add('error', SKILL, 1, 'size', `SKILL.md is ${skillBytes} bytes; keep it at 19,000 or under so the 5,000 tokens a harness re-attaches after compaction still hold Step 7`);
for (const f of themeFiles) {