Qi Layer

Schrijft en onderhoudt AGENTS.md en .context/CONTEXT.md als gelaagde codebase-documentatie

Door haowjy · haowjy/creative-writing-skills

Getest · Werkt ★ 8.8/10

Qi Layer — Schrijft en onderhoudt AGENTS.md en .context/CONTEXT.md als gelaagde codebase-documentatie

Wat het doet

Een begeleidende skill voor het opstellen van het code-lokale documentatiepaar AGENTS.md en .context/CONTEXT.md, gebruikmakend van vier principes (fractal compression, hierarchical summarization, LCA deduplication, progressive disclosure) plus expliciete tests voor wat op elk niveau thuishoort. Triggert wanneer je deze agent-gerichte intent-docs voor een codebase schrijft, trimt of onderhoudt — niet voor docstrings, READMEs of code-level comments. Het duwt referentiedetails naar .context/ en houdt root AGENTS.md gericht op beslissingskritische kennis.

Testrapport

SKILL.md (HTTP 200) en resources/references.md (200) opgehaald; beide gerefereerde sibling skills knowledge-layers en llm-writing lossen op (200). Frontmatter parseert met name+description; geen scripts, geen curl|sh, geen exfiltratie — references.md citeert slechts twee externe URL's als ontwerpbronnen. Output test: een AGENTS.md geschreven voor een voorbeeld sliding-window rate-limit module, zowel zonder als met de skill. Baseline vertelde de code bestand-voor-bestand en bevatte een "TODO"/"in-memory" statussectie (precies de sessie-bleed die de skill markeert); de skill-versie begon in plaats daarvan met beslissingskritische valkuilen die de baseline nooit vermeldde ("effectieve globale limiet is max_hits × workers", "peek verbruikt twee slots", "a False betekent vertragen, niet opnieuw proberen") en verplaatste algoritme/Redis/O(n) details naar .context/CONTEXT.md. Trigger beoordelingen: 3 authoring/trimming zinnen laden het, docstring en README-install zinnen doen dat correct niet (5/5).

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/qi-layer-src
mkdir -p ~/.claude/skills
cp -R /tmp/qi-layer-src/cw/skills/qi-layer ~/.claude/skills/qi-layer
# SKILL.md lands at ~/.claude/skills/qi-layer/SKILL.md ; bundled resources/references.md comes with it.
# Soft deps: SKILL.md body says "Load /knowledge-layers" and "/llm-writing". Those are sibling
# skills in the same repo (cw/skills/knowledge-layers, cw/skills/llm-writing). The core guidance
# is fully inline and works standalone; install those two the same way if you want the extras.
# No API keys, no build step, no scripts to run.

Commando's en voorbeeldprompts

  • /qi-layerSchrijft en onderhoudt AGENTS.md en .context/CONTEXT.md als gelaagde codebase-documentatie

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

  • Explore this codebase using AGENTS.md as context
  • Update CONTEXT.md after this change
  • Keep this intent doc concise before committing