Qi Layer

Escribe y mantiene AGENTS.md y .context/CONTEXT.md como documentos de codebase en capas

Por haowjy · haowjy/creative-writing-skills

Probado · Funciona ★ 8.8/10

Qi Layer — Escribe y mantiene AGENTS.md y .context/CONTEXT.md como documentos de codebase en capas

Qué hace

Una habilidad de guía para la autoría del par de documentación local de código AGENTS.md y .context/CONTEXT.md, utilizando cuatro principios (compresión fractal, resumen jerárquico, deduplicación LCA, divulgación progresiva) más pruebas explícitas de lo que pertenece a cada nivel. Se activa cuando se escriben, recortan o mantienen estos documentos de intención orientados a agentes para una base de código, no para docstrings, READMEs o comentarios a nivel de código. Empuja los detalles de referencia a .context/ y mantiene el AGENTS.md raíz enfocado en el conocimiento crítico para la toma de decisiones.

Informe de la prueba

SKILL.md (HTTP 200) y resources/references.md (200) obtenidos; ambas habilidades hermanas referenciadas knowledge-layers y llm-writing se resuelven (200). El frontmatter se analiza con name+description; sin scripts, sin curl|sh, sin exfiltración — references.md solo cita dos URLs externas como fuentes de diseño. Prueba de salida: escribí un AGENTS.md para un módulo de límite de velocidad de ventana deslizante de muestra tanto sin como con la habilidad. La línea base narró el código archivo por archivo y llevaba una sección de estado "TODO"/"in-memory" (exactamente la fuga de sesión que la habilidad marca); la versión de la habilidad, en cambio, comenzó con puntos críticos para la toma de decisiones que la línea base nunca mencionó ("effective global limit is max_hits × workers", "peek consumes two slots", "a False means slow down, not try again") y movió los detalles de algoritmo/Redis/O(n) a .context/CONTEXT.md. Juicios de activación: 3 frases de autoría/recorte lo cargan, las frases de docstring y README-install no lo hacen correctamente (5/5).

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

Instalación

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.

Comandos y prompts de ejemplo

  • /qi-layerEscribe y mantiene AGENTS.md y .context/CONTEXT.md como documentos de codebase en capas

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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