Knowledge Layers

Bepaalt of een document thuishoort in AGENTS.md, .context/, de KB, docs/, of een werkmap

Door haowjy · haowjy/creative-writing-skills

Getest · Werkt ★ 8.4/10

Knowledge Layers — Bepaalt of een document thuishoort in AGENTS.md, .context/, de KB, docs/, of een werkmap

Wat het doet

Leidt projectkennis naar een van de vijf lagen — AGENTS.md, .context/CONTEXT.md, een cross-cutting kennisbank, docs/, of een tijdelijke werkmap — met behulp van expliciete plaatsingsregels, en definieert KB-conventies voor wikipagina's, beslissingsrecords, naamgeving en archivering van verouderde inhoud. Activeert wanneer je vraagt waar een stuk documentatie moet komen, wanneer je AGENTS.md / .context/ / KB-pagina's schrijft of bijwerkt, of wanneer je een kennisbank wilt bootstrappen of lint-controleren op verouderde en weesinhoud. Inclusief een starter kb/ lay-out en een governance AGENTS.md template in resources/bootstrap.md.

Testrapport

Geïnstalleerd in een tijdelijke HOME (git clone + cp van cw/skills/knowledge-layers); frontmatter geparset met name+description, resources/bootstrap.md en de vijf sibling skills die het aanroept, halen allemaal HTTP 200 op, geen scripts/netwerkoproepen/geheimen in beide bestanden. Trigger set — JA: "Where should this JWT decision live, the gateway's AGENTS.md or the kb?", "Bootstrap a kb/ structure for this project", "Our docs/ and .context/ files contradict each other, lint them"; NEE: "Add docstrings to the functions in utils.py", "Where in the codebase should the new rate-limiter module live?" — alle 5 beoordeeld zoals bedoeld. Uitvoertest: dezelfde auth-migratie documentatietaak tweemaal. Baseline produceerde één bestand, docs/auth-jwt-migration.md, genoemd naar de gebeurtenis en vertellend over zijn eigen geschiedenis ("Until Q2 we used…", "In June we migrated…", "Deployed to staging June 3"), met rationale, huidige mechanica, rollout log en een gateway-only feit door elkaar. Skill-gevolgde run produceerde vier artefacten — kb/auth/token-verification.md (genoemd naar wat het beschrijft, mermaid sequentiediagram, een "> [!FLAG] **Needs human review**" op niet-geïmplementeerde refresh rotatie), een nieuw beslissingsrecord 0007 met afgewezen opties, een superseded-status bewerking op het oude 0003 record, en een kb/index.md catalogusregel — plus een expliciete uitsluitingslijst die het rollout-verhaal naar een werkmap en het legacy/ dir feit naar services/api-gateway/.context/ leidt. Echte structurele verandering, geen bewoording; kanttekening is dat het een repo veronderstelt die al een kb/ + .context/ lay-out draait.

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/haowjy/creative-writing-skills.git /tmp/knowledge-layers-src
mkdir -p ~/.claude/skills
cp -R /tmp/knowledge-layers-src/cw/skills/knowledge-layers ~/.claude/skills/knowledge-layers
for d in qi-layer information-hierarchy llm-writing shared-dao md-validation; do cp -R /tmp/knowledge-layers-src/cw/skills/$d ~/.claude/skills/$d; done
# The 5 extra dirs are siblings the SKILL.md body invokes by name (/qi-layer, /information-hierarchy,
# /llm-writing, /shared-dao, /md-validation). knowledge-layers works without them, but those
# references dangle. Copy only the first dir if you want the skill alone.
# Plugin alternative (installs all 24 skills + the creative-writing agents):
#   /plugin marketplace add haowjy/creative-writing-skills
#   /plugin install creative-writing-skills@cw
# No scripts, no deps, no API keys — the skill is two markdown files.

Commando's en voorbeeldprompts

  • /knowledge-layersBepaalt of een document thuishoort in AGENTS.md, .context/, de KB, docs/, of een werkmap

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Where should I document this new convention
  • Read the durable docs before making changes
  • Organize this knowledge into the right layer