Knowledge Layers

Decide se un documento appartiene a AGENTS.md, .context/, la KB, docs/, o una directory di lavoro

di haowjy · haowjy/creative-writing-skills

Promosso ★ 8.4/10

Knowledge Layers — Decide se un documento appartiene a AGENTS.md, .context/, la KB, docs/, o una directory di lavoro

Cosa fa

Instrada la conoscenza del progetto in uno dei cinque strati — AGENTS.md, .context/CONTEXT.md, una base di conoscenza trasversale, docs/, o una directory di lavoro temporanea — utilizzando regole di posizionamento esplicite, e definisce convenzioni KB per pagine wiki, record di decisioni, denominazione e archiviazione di contenuti superati. Si attiva quando si chiede dove dovrebbe risiedere un pezzo di documentazione, quando si stanno scrivendo o aggiornando pagine AGENTS.md / .context/ / KB, o quando si desidera che una base di conoscenza venga avviata o controllata con lint per contenuti obsoleti e orfani. Include un layout kb/ di partenza e un template AGENTS.md di governance in resources/bootstrap.md.

Rapporto di test

Installato in una HOME temporanea (git clone + cp di cw/skills/knowledge-layers); frontmatter analizzato con name+description, resources/bootstrap.md e le cinque skill sorelle che invoca recuperano tutte HTTP 200, nessun script/chiamata di rete/segreto in entrambi i file. Set di trigger — SÌ: "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"; NO: "Add docstrings to the functions in utils.py", "Where in the codebase should the new rate-limiter module live?" — tutti e 5 giudicati come previsto. Test di output: stesso task di documentazione della migrazione auth due volte. La baseline ha prodotto un file, docs/auth-jwt-migration.md, nominato per evento e narrante la propria storia ("Fino al Q2 abbiamo usato…", "A giugno siamo migrati…", "Deployato in staging il 3 giugno"), con motivazione, meccanismi attuali, log di rollout e un fatto solo gateway mescolati insieme. L'esecuzione seguita dalla skill ha prodotto quattro artefatti — kb/auth/token-verification.md (nominato da ciò che descrive, diagramma di sequenza mermaid, un "> [!FLAG] **Needs human review**" sulla rotazione di refresh non implementata), un nuovo record di decisione 0007 che elenca le opzioni rifiutate, una modifica dello stato di superamento sul vecchio record 0003 e una riga di catalogo kb/index.md — più una lista di esclusione esplicita che instrada la narrativa del rollout a una directory di lavoro e il fatto legacy/ dir a services/api-gateway/.context/. Vero cambiamento strutturale, non di formulazione; l'avvertenza è che presuppone un repository che già esegue un layout kb/ + .context/.

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /knowledge-layersDecide se un documento appartiene a AGENTS.md, .context/, la KB, docs/, o una directory di lavoro

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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