Skip to content

content: add practitioner skill collections + curated IA refactor#73

Merged
wilsonwangdev merged 2 commits into
mainfrom
content/curated-practitioner-skills
May 8, 2026
Merged

content: add practitioner skill collections + curated IA refactor#73
wilsonwangdev merged 2 commits into
mainfrom
content/curated-practitioner-skills

Conversation

@wilsonwangdev
Copy link
Copy Markdown
Owner

Summary

Adds a "Practitioner Skill Collections" group to the curated section with three seed entries, and restructures the curated section's information architecture so the index page becomes the canonical browsing entry instead of a sibling of the entries.

Content

Three seed entries under content/curated/entries/ (EN+ZH, with source: frontmatter so the build emits citation/isBasedOn JSON-LD):

  • Andrej Karpathy: LLM Wiki — persistent-artifact architecture for agent memory, an alternative to chunk-retrieval RAG
  • Addy Osmani: agent-skills — production-grade skills organized by software lifecycle phase (Define → Plan → Build → Verify → Review → Ship)
  • Matt Pocock: skills — small, composable, model-agnostic skills as a counterweight to lifecycle frameworks

Naming uses "Practitioner Skill Collections" rather than "KOL" to avoid subjective ranking and emphasize traceable authorship — selection criteria require named author with traceable background, independent thinking (not vendor-doc restatement), and active maintenance or a clearly dated snapshot.

IA refactor

Before this PR, sections with an index page (only curated) were inconsistent: the curated index existed but appeared on the homepage as one item among siblings, and breadcrumb "Curated" links from detail pages went back to the homepage instead of the index.

Two changes in build/build.mjs fix both:

  • Homepage listing detects sections that have an index page (rel === section) and collapses the listing to that single link. Sections without an index (concepts, guides, evangelism) are unchanged.
  • Breadcrumb sectionPath checks existsSync(content/<section>/index.<lang>.md) and points to the section index when present, otherwise falls back to the homepage.

The curated index page itself is restructured into two parallel groups (Official Articles · Practitioner Skill Collections), each with its own selection criteria.

Layer (per SPEC 006)

Layer 1 — Universal Content. New entries are commentary curating external work; no project-specific references. Build changes are repo-internal and don't affect Layer 2 distributables.

Verification

  • npm run build produces 36 pages without errors
  • All 12 new HTML files (6 entries × 2 langs) return 200 locally
  • JSON-LD on each entry includes citation + isBasedOn pointing to the source repo/gist
  • llms.txt and llms-full.txt regenerate to include the new entries
  • Heading IDs on the curated index are unique (verified after renaming the criteria subheadings)
  • Breadcrumb "Curated" link on detail pages now correctly returns to /en/curated/ or /zh/curated/
  • Homepage curated section collapses to a single "Curated Articles / 精选文章" link

…on link

Sections that have an index page (currently only curated) now collapse to
a single index link on the homepage, and breadcrumb section links on
detail pages point to the section index instead of the homepage. Sections
without an index (concepts, guides, evangelism) are unchanged.

Both behaviors detect the index by checking for content/<section>/index.<lang>.md.
Adds three seed entries under content/curated/entries/ with a
practitioner- prefix to distinguish from official-source articles:

- Andrej Karpathy: LLM Wiki — persistent-artifact agent memory
- Addy Osmani: agent-skills — lifecycle-organized production skills
- Matt Pocock: skills — small composable model-agnostic skills

Each entry follows the existing curated frontmatter (lang, pair, source,
status) so the build emits citation/isBasedOn JSON-LD pointing back to
the original repos and gist.

The curated index page is restructured into two groups (Official
Articles, Practitioner Skill Collections) with separate selection
criteria, becoming the canonical browsing entry for the section.
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agent-master-handbook Ready Ready Preview, Comment May 8, 2026 4:31pm

@wilsonwangdev wilsonwangdev merged commit 6050d33 into main May 8, 2026
3 checks passed
@wilsonwangdev wilsonwangdev deleted the content/curated-practitioner-skills branch May 8, 2026 16:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant