---
title: Actualizaciones automáticas de documentación
description: "Mantén docs y código en sincronía con /update-jamdesk para Claude Code. Actualiza la documentación automáticamente cuando implementas nuevas funciones."
---
El skill `/update-jamdesk` para Claude Code observa los cambios en tu código y genera las actualizaciones de documentación correspondientes. Después de lanzar una funcionalidad orientada al usuario, ejecuta el skill y determinará qué páginas de documentación necesitan crearse o editarse.
**¿Buscas consejos generales de escritura con IA?** Esta página cubre el skill `/update-jamdesk` para actualizaciones automáticas de documentación. Para la configuración de herramientas, consulta [Claude Code](/es/ai/claude-code). Para una guía más amplia sobre el uso de herramientas de IA para escribir docs, consulta [Escribir con IA](/es/ai/writing-with-ai).
## Cuándo usarlo
**Úsalo cuando:** Has realizado cambios orientados al usuario en APIs, comandos CLI, interfaz de usuario, opciones de configuración o comportamiento de componentes.
**Omítelo cuando:** Refactorizaciones internas, cambios solo de pruebas, configuración de build/CI, o trabajo de rendimiento sin cambio de comportamiento — estos no necesitan documentación orientada al usuario.
## Requisitos previos
- [Claude Code](https://claude.ai/code) instalado y configurado
- Un proyecto de documentación Jamdesk con `docs.json`
- Opcional: [CLI de Jamdesk](/es/cli/overview) para verificación (`npm install -g jamdesk`)
## Inicio rápido
Crea un archivo `.jamdesk-docs-path` en tu repositorio de código apuntando a tus docs:
```yaml .jamdesk-docs-path
docs_path: ../my-docs
```
La ruta puede ser relativa (desde el archivo de configuración) o absoluta.
Después de implementar una funcionalidad, ejecuta:
```text
/update-jamdesk
```
Claude analizará tus cambios y hará preguntas de aclaración antes de escribir la documentación.
Revisa la documentación generada; luego Claude la verificará con `jamdesk validate` y `jamdesk broken-links` antes de confirmar los cambios.
## Formato del archivo de configuración
El archivo `.jamdesk-docs-path` le indica a Claude dónde se encuentra tu documentación.
**Formato simple** - solo la ruta:
```text
../my-docs
```
**Formato completo** - con opciones:
```yaml .jamdesk-docs-path
# Path to documentation repository
docs_path: ../my-docs
# Optional: Branch for doc updates (default: main)
docs_branch: main
```
El archivo de configuración se descubre recorriendo hacia arriba desde tu directorio actual hasta la raíz del repositorio git. Colócalo en la raíz de tu repositorio para obtener mejores resultados.
## Cómo funciona
Cuando ejecutas `/update-jamdesk`, Claude:
1. **Localiza tus docs** - Encuentra el archivo de configuración `.jamdesk-docs-path`
2. **Hace preguntas** - Clarifica la estrategia de ramas, el alcance y el contenido
3. **Analiza los docs existentes** - Busca contenido relacionado para actualizar o extender
4. **Escribe la documentación** - Crea o actualiza páginas siguiendo los estándares de Jamdesk, con ejemplos simples primero
5. **Revisa el tono** - Comprueba el resultado en busca de relleno generado por IA. Claude escribe mejor con un CLAUDE.md que establezca la voz (consulta [Claude Code](/es/ai/claude-code))
6. **Verifica** - Ejecuta `jamdesk validate` y `jamdesk broken-links`
7. **Confirma** - Prepara los cambios y ofrece confirmar/enviar/crear PR
¿No te gustan los cambios? Ejecuta `git checkout .` antes de confirmar para revertir todas las ediciones.
| Escenario | Acción |
|----------|--------|
| Nueva funcionalidad | Crear nueva página |
| Cambio de comportamiento | Actualizar página existente |
| Adición pequeña | Añadir sección a página existente |
| Capacidad mayor | Nueva página independiente |
| Deprecación/eliminación | Actualizar existente + añadir notas de migración |
## Ejemplo de sesión
```text
User: I just added a webhook feature. Can you document it?
Claude: I'm using the update-jamdesk skill to update your documentation.
Found .jamdesk-docs-path: ../customer-docs
How should I handle changes to the docs repository?
1. Create a new feature branch (recommended)
2. Update directly on main
3. Use current branch
User: 1
Claude: Based on the webhook implementation, I plan to:
- Create: webhooks/overview.mdx
- Update: getting-started.mdx (add link)
Any changes to this plan?
User: Looks good
Claude: [Creates documentation...]
✓ jamdesk validate passed
✓ jamdesk broken-links passed
Commit these changes?
```
## Modo preview
Ejecuta con `--preview` para ver qué cambiaría sin realizar ediciones:
```text
/update-jamdesk --preview
```
El modo preview te permite:
- Comprobar qué documentación necesita actualizarse
- Revisar los cambios propuestos antes de confirmarlos
- Ver el análisis del skill sin efectos secundarios
## Sugerencias proactivas
Después de confirmar cambios de código orientados al usuario, Claude puede sugerir:
```text
Tip: These changes affect user-facing features.
Run /update-jamdesk to update your documentation.
```
Esto aparece cuando:
- Tienes un archivo de configuración `.jamdesk-docs-path`, Y
- Tu confirmación incluye archivos que coinciden con patrones orientados al usuario (API, CLI, componentes)
## Instalar el skill
Instala el skill `/update-jamdesk` usando el CLI de skills:
```bash
npx skills add jamdesk/skills --skill update-jamdesk
```
Esto instala el skill en `.claude/skills/update-jamdesk/` en tu proyecto.
Instala en el directorio de tu proyecto actual:
```bash
npx skills add jamdesk/skills --skill update-jamdesk
```
El skill está disponible cuando trabajas en este proyecto.
Instala en tu directorio de inicio para usarlo en todos los proyectos:
```bash
npx skills add jamdesk/skills --skill update-jamdesk -g
```
El skill está disponible en cualquier proyecto.
Instala en Cursor, Codex, Windsurf u otros agentes compatibles:
```bash
# Install to Cursor
npx skills add jamdesk/skills --skill update-jamdesk -a cursor
# Install to multiple agents
npx skills add jamdesk/skills --skill update-jamdesk -a claude-code -a cursor
```
Ejecuta `npx skills add --help` para ver todos los agentes compatibles.
### Ver los skills disponibles
Ver todos los skills de Jamdesk:
```bash
npx skills add jamdesk/skills --list
```
### Actualizar
Vuelve a ejecutar el comando de instalación para obtener la última versión:
```bash
npx skills add jamdesk/skills --skill update-jamdesk
```
Después de instalar o actualizar, reinicia Claude Code o inicia una nueva sesión para que los cambios surtan efecto.
## Solución de problemas
Asegúrate de que el archivo del skill esté en `.claude/skills/update-jamdesk/SKILL.md` y reinicia tu sesión de Claude Code.
Crea `.jamdesk-docs-path` en la raíz de tu repositorio con la ruta a tu directorio de docs. El skill busca desde tu directorio actual hasta la raíz del repositorio git.
Instala con `npm install -g jamdesk`. El skill funcionará sin él, pero no ejecutará la validación automática.
## ¿Qué sigue?
Conecta asistentes de IA directamente a tus docs
Aprende sobre el CLI de jamdesk para el desarrollo local