From b484302afd7c99907fb047dabaebf66f68dc441a Mon Sep 17 00:00:00 2001 From: Marcos Paulo Date: Sat, 5 Sep 2026 06:22:16 +0000 Subject: [PATCH] docs: point generator references at the content collection MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The build-skill-review.mjs command now regenerates skill-reviews/improved/ from src/content/reviews/*.md, not from skills-review/catalog.js. Update the essential-commands line in AGENTS.md and the review desk footer in skills-review/index.html to match. Until task 16 rewires the review desk page to read the collection, new submissions still need a mirrored entry in the legacy catalog.js — the footer spells that out explicitly. Co-Authored-By: Claude Code --- AGENTS.md | 4 ++-- skills-review/index.html | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 1589dd7..7231a4d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,7 +26,7 @@ labs are dependency-free HTML/CSS/JS that workshop attendees point an agent at. ```bash pnpm run verify # content + interaction contracts (scripts/verify.mjs) — the gate node scripts/audit-ui.mjs # responsive / no-external-dependency audit -node scripts/build-skill-review.mjs # regenerate skill-reviews/improved/ from catalog.js +node scripts/build-skill-review.mjs # regenerate skill-reviews/improved/ from src/content/reviews/ pnpm run serve # python3 -m http.server 4173 ``` @@ -52,7 +52,7 @@ so. _is_ that they are dependency-free vanilla HTML/CSS/JS an attendee can hand to an agent. Componentizing them destroys the lesson. They ship as static assets. - `submitted-skills/` — other people's submitted work, reproduced verbatim -- `skill-reviews/improved/` — generated; edit `skills-review/catalog.js` instead +- `skill-reviews/improved/` — generated; edit `src/content/reviews/*.md` instead - `vote-service/` — separate deploy lifecycle; do not fold into the site build - `dist/`, `node_modules/` — build output, never committed - `pnpm-lock.yaml` — **committed, but never hand-edited.** Change it only as a diff --git a/skills-review/index.html b/skills-review/index.html index aec1d30..807b459 100644 --- a/skills-review/index.html +++ b/skills-review/index.html @@ -38,7 +38,7 @@

The recommendations follow the open Agent Skills format: valid frontmatter for discovery, progressive disclosure for context economy, deterministic scripts for fragile repeated mechanics, and behavioral evaluation rather than a checklist of pretty headings.

Format specification ↗Writing practices ↗Evaluation loop ↗Scripts guide ↗
-
Share an author with ?author=Name, or one review with ?author=Name&skill=skill-id&view=improved. To add a submission later: drop a package under submitted-skills/, add a tailored entry in skills-review/catalog.js, then run node scripts/build-skill-review.mjs. Votes call a separate service — see vote-service/ — one per visitor, tracked by network source.
+
Share an author with ?author=Name, or one review with ?author=Name&skill=skill-id&view=improved. To add a submission later: drop a package under submitted-skills/, add an entry under src/content/reviews/{new-id}.md (and mirror it into skills-review/catalog.js until task 16 rewires the page to read the collection), then run node scripts/build-skill-review.mjs. Votes call a separate service — see vote-service/ — one per visitor, tracked by network source.