Qi Layer

Skriv og vedligehold AGENTS.md og .context/CONTEXT.md som lagdelte codebase-dokumenter

Af haowjy · haowjy/creative-writing-skills

Testet · Virker ★ 8.8/10

Qi Layer — Skriv og vedligehold AGENTS.md og .context/CONTEXT.md som lagdelte codebase-dokumenter

Hvad det gør

En vejledningsfærdighed til forfatterskab af det kodelokale dokumentationspar AGENTS.md og .context/CONTEXT.md, ved brug af fire principper (fraktal kompression, hierarkisk opsummering, LCA deduplikering, progressiv afsløring) plus eksplicitte tests for, hvad der hører til på hvert niveau. Udløses, når du skriver, trimmer eller vedligeholder disse agent-vendte intent-dokumenter for en codebase — ikke for docstrings, READMEs eller kode-niveau kommentarer. Den skubber referencedetaljer ned i .context/ og holder rod-AGENTS.md fokuseret på beslutningskritisk viden.

Testrapport

Hentede SKILL.md (HTTP 200) og resources/references.md (200); begge refererede søskendefærdigheder knowledge-layers og llm-writing løser (200). Frontmatter parser med name+description; ingen scripts, ingen curl|sh, ingen exfiltration — references.md citerer kun to eksterne URL'er som designkilder. Outputtest: skrev en AGENTS.md for et eksempel på et sliding-window rate-limit modul både uden og med færdigheden. Baseline fortalte koden fil for fil og havde en "TODO"/"in-memory" statussektion (præcis den session-bleed, færdigheden markerer); færdighedsversionen startede i stedet med beslutningskritiske faldgruber, baselinen aldrig nævnte ("effektiv global grænse er max_hits × workers", "peek forbruger to slots", "en False betyder sænk farten, ikke prøv igen") og flyttede algoritme/Redis/O(n) detaljer ind i .context/CONTEXT.md. Triggerbedømmelser: 3 forfatnings-/trimningsfraseringer indlæser den, docstring og README-installationsfraseringer gør det korrekt ikke (5/5).

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

Installation

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.

Kommandoer og eksempelprompter

/qi-layerSkriv og vedligehold AGENTS.md og .context/CONTEXT.md som lagdelte codebase-dokumenter

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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

Læs hele rapporten →