# Documentacion Tecnica

> Habilidad esencial para la creación, organización y mantenimiento de documentación técnica clara, precisa y accesible para desarrolladores (Docs-as-Code) y usuarios finales. Úsala para tareas de Proyectos y Colaboración: technical-writing, markdown, documentation, api-docs, software-architecture, developer-experience.

- Skill: `jesusgarciafernandez/documentacion-tecnica` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jesusgarciafernandez/documentacion-tecnica`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jesusgarciafernandez/documentacion-tecnica/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: CC BY-NC-SA 4.0
- Author: jesusgarciafernandez (https://skillmd.com/u/jesusgarciafernandez)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jesusgarciafernandez/documentacion-tecnica

---


## 0. Filosofía Human-Centric AI
*Esta sección es obligatoria para cumplir con los estándares del App Blueprint Generator.*

**El Rol del Humano:** Supervisión estratégica y validación ética de los resultados generados.
**Empoderamiento:** Esta Skill dota al profesional de una escala productiva 10x mediante la automatización de la carga cognitiva repetitiva.

## Descripción
Habilidad esencial para la creación, organización y mantenimiento de documentación técnica clara, precisa y accesible para desarrolladores (Docs-as-Code) y usuarios finales. Esta skill se centra en la capacidad de traducir conceptos técnicos complejos en guías de usuario, manuales de referencia de API, diagramas de arquitectura y especificaciones de requisitos. Abarca el dominio de lenguajes de marcado como Markdown y MDX, herramientas de generación de sitios de documentación (Docusaurus, GitBook), y la integración de la documentación en el ciclo de vida del desarrollo mediante Pull Requests y CI/CD. El objetivo es maximizar la mantenibilidad del software y mejorar la experiencia de los desarrolladores (DX) que interactúan con el sistema.

## Cuándo usarla
Escenarios que activan esta skill:
- Al iniciar un nuevo proyecto de software que requiera una arquitectura documentada para evitar silos de conocimiento.
- Para documentar APIs públicas o internas que deban ser consumidas por otros equipos o aplicaciones de terceros.
- Durante la creación de guías de contribución (CONTRIBUTING.md) y estándares de código para proyectos de código abierto o corporativos.
- Cuando se busca estandarizar la base de conocimientos interna sobre infraestructuras o procesos de despliegue.
- Para cumplir con normativas de calidad o auditorías técnicas que exijan una trazabilidad documental rigurosa.

## Requisitos
- Dominio de lenguajes de marcado (Markdown).
- Capacidad de síntesis y claridad en la redacción técnica.
- Conocimientos básicos de control de versiones (Git).
- Familiaridad con herramientas de diagramación (Mermaid.js, Lucidchart).
- Entendimiento de los principios de diseño de información y arquitectura de documentación.

## Instrucciones y Pasos detallados que se debe seguir:


## Workflow N8N
Referencia al archivo `workflow.json` o scripts integrados.

## Notas y advertencias
- ⚠️ **Mantenimiento Técnico**: Requiere verificación mensual.

## Changelog
- v1.0 — Versión inicial
- v1.1 — Enriquecimiento técnico especializado y normalización de formato V1.1