mcpField
D
doc-writer

doc-writer

github.com/testacodeDocuments52 installs
Repository

About doc-writer

doc-writer is a skill for creating technical documents in a project's existing documentation structure. It helps project teams place documents in the right category and apply matching templates.

Key features

  1. 01Checks the existing docs/ structure
  2. 02Offers documentation categories
  3. 03Names files by date or ADR sequence
  4. 04Applies templates for specs, plans, ADRs, and references

Use cases

  1. 01Adding a feature specification to a project
  2. 02Recording an architectural decision
  3. 03Writing a technical plan or reference document

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/testacode/llm-toolkit --skill doc-writer

After installing, type/doc-writerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
adr-example.md
adr-template.md
plan-example.md
plan-template.md
reference-example.md
reference-template.md
spec-example.md
spec-template.md

Details

From the project README

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:

CategoriaUso
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/:

TipoTemplateEjemplo
Specreferences/spec-template.mdreferences/spec-example.md
Planreferences/plan-template.mdreferences/plan-example.md
ADRreferences/adr-template.mdreferences/adr-example.md
Referencereferences/reference-template.mdreferences/reference-example.md

Comments

Markdown supported