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
- 01Checks the existing docs/ structure
- 02Offers documentation categories
- 03Names files by date or ADR sequence
- 04Applies templates for specs, plans, ADRs, and references
Use cases
- 01Adding a feature specification to a project
- 02Recording an architectural decision
- 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-writerAfter installing, type/doc-writerin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/adr-example.mdadr-template.mdplan-example.mdplan-template.mdreference-example.mdreference-template.mdspec-example.mdspec-template.mdDetails
From the project READMEDoc 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
- Crear subcarpeta si no existe
- 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
- Spec:
- 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 |
Comments
Markdown supported