# Instrucciones para el agente: anydoc: documentos de oficina en Markdown para tu agente

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/firecrawl/anydoc (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/anydoc

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

Para la CLI directa, comprueba que Node.js ≥20 y npm/npx están disponibles, según [node/package.json](https://github.com/firecrawl/anydoc/blob/main/node/package.json). Si además instalas la skill, la [CLI skills actual](https://github.com/vercel-labs/skills/blob/main/package.json) exige Node.js ≥22.20.0.

### Paso 1: elige CLI o skill

Para enseñar el uso al agente, el README incluye:

```bash
npx skills add firecrawl/anydoc
```

Puedes usar la CLI sin instalar la skill.

### Paso 2: convierte un documento de prueba

Usa los ejemplos oficiales con archivos tuyos que tengan esos nombres:

```bash
npx @firecrawl/anydoc report.docx
npx @firecrawl/anydoc slides.pptx -o slides.md
```

El primero imprime Markdown y el segundo escribe `slides.md`.

## Comprobación

Compara los títulos, las listas y una tabla del original con la salida. Pide al agente que lea el Markdown y señale qué información usa para su respuesta. No basta con que el proceso termine si faltan partes que necesitas.

## Si algo falla

`NeedsOcr` indica páginas escaneadas o de imagen. Decide si autorizas enviarlas al OCR alojado; no lo actives automáticamente para documentos privados. Revisa también los errores `Encrypted`, `Unsupported` y `Malformed` descritos en el [README](https://github.com/firecrawl/anydoc#errors). Para problemas de API usa el README específico de Node, Python o WebAssembly enlazado desde el repo.