Agent-Skills.md

Agent Skills: Doc Writer

Este skill se usa para crear documentos tecnicos organizados en /docs (specs, planes de implementacion, ADRs, documentacion de referencia). Se activa cuando el usuario dice "crear documento", "escribir spec", "documentar esto", "creame una spec", "escribime documentacion", "hacer documentacion", "write a spec", "create documentation", "write an ADR", o quiere agregar documentacion tecnica al proyecto.

UncategorizedID: testacode/llm-toolkit/doc-writer

Repository

testacode/llm-toolkit
testacodeLicense: Apache-2.0

Install this agent skill to your local

pnpm dlx add-skill https://github.com/testacode/llm-toolkit/tree/HEAD/skills/doc-writer

Skill Files

Browse the full folder contents for doc-writer.

Download Skill

Loading file tree…

skills/doc-writer/SKILL.md

Skill Metadata

Name
doc-writer
Description
Este skill se usa para crear documentos tecnicos organizados en /docs (specs, planes de implementacion, ADRs, documentacion de referencia). Se activa cuando el usuario dice "crear documento", "escribir spec", "documentar esto", "creame una spec", "escribime documentacion", "hacer documentacion", "write a spec", "create documentation", "write an ADR", o quiere agregar documentacion tecnica al proyecto.

Doc Writer

Skill para crear documentos tecnicos en la estructura correcta del proyecto.

Proceso de Creacion

Paso 1: Buscar estructura de docs existente

Verificar si existe docs/ y sus subcarpetas.

Paso 2: Determinar categoria

Si existen subcarpetas en docs/: ofrecerlas como opciones.

Si no existen subcarpetas, preguntar al usuario:

| Categoria | Uso | |-----------|-----| | specs/ | Especificaciones de features/sistemas | | planning/ | Planes de implementacion activos | | archive/ | Documentos completados o superseded | | architecture/ | ADRs, decisiones arquitectonicas | | reference/ | Documentacion tecnica de referencia | | backlog/ | Features pendientes, ideas futuras | | work-in-progress/ | Documentacion de trabajo activo |

Paso 3: Generar nombre de archivo

Formato: YYYY-MM-DD-<feature-name>.md

  • Usar fecha actual (sin hora)
  • <feature-name> en kebab-case, descriptivo, sin espacios
  • Excepcion: ADRs usan NNNN-<name>.md (numero secuencial)

Paso 4: Crear el documento

  1. Crear subcarpeta si no existe
  2. Leer y aplicar el template correspondiente de references/:
    • Spec: references/spec-template.md
    • Plan: references/plan-template.md
    • ADR: references/adr-template.md
    • Reference: references/reference-template.md
  3. Escribir archivo en la ubicacion correcta

Recursos

Para ver ejemplos completos de cada tipo de documento, leer los archivos en references/:

| Tipo | Template | Ejemplo | |------|----------|---------| | Spec | references/spec-template.md | references/spec-example.md | | Plan | references/plan-template.md | references/plan-example.md | | ADR | references/adr-template.md | references/adr-example.md | | Reference | references/reference-template.md | references/reference-example.md |