orchestrator — coordinador de entrada

English version: SKILL.en.md

¿Qué hace orchestrator — coordinador de entrada?

Habilidad delgada autoescrita: sin código propio — recibe entrada, identifica su tipo y la deriva al lugar correcto.

Habilidades en este repositorio

Habilidad	Úsala cuando
doc	PDF/DOCX/XLSX: extraer texto, OCR, convertir, dividir/combinar páginas
media	video/audio/imágenes/URL: resumir, extraer texto, subtítulos, recortar, extraer fotogramas, descargar
paper	redactar informes según estándares internacionales o informes populares de Vietnam
web	leer sitios web/noticias/redes sociales + buscar (Jina, agent-reach, exa)
diagram	dibujar diagramas Mermaid / gráficos matplotlib para informes
orchestrator (esta habilidad)	coordinar las habilidades anteriores + portal de preguntas antes del informe

Instala todo lo necesario para que funcione la coordinación: npx skills add tpc-pascal/agent-skills --all (o --skill orchestrator web doc media paper diagram).

Tabla de ruteo según tipo de entrada

Entrada + necesidad	Lugar de procesamiento
PDF/DOCX/XLSX (texto, OCR, conversión, división/combinación)	habilidad doc
video/audio/imágenes/URL multimedia (resumen, subtítulos, recorte, fotogramas, descarga)	habilidad media
Leer web/redes sociales/buscar (URL, artículo, exa)	habilidad web
Escribir informe a partir de fuentes	Portal de preguntas (sección a continuación) → elegir un tipo en la habilidad paper
Dibujar diagramas/gráficos para el informe	habilidad diagram

Cierre de requisitos del informe

Disparador: el usuario solicita crear o reescribir un informe; no aplica a solicitudes de solo extracción/conversión.

Antes de investigar en profundidad o redactar un informe, formula una ronda de hasta 4 preguntas, solo sobre lo que falte:

• Tipo: ¿informe estándar internacional o informe popular de Vietnam?

• Propósito y audiencia: ¿quién lo leerá? ¿qué pregunta debe responder?

• Salida: ¿idioma, formato y límite de extensión, si lo hay?

• Fuentes y alcance: ¿qué fuentes/secciones usar? ¿se permite añadir fuentes externas?

• No preguntes de nuevo lo que ya está en la solicitud/conversación. Si el usuario delega la decisión, elige la opción adecuada y menciona brevemente los supuestos que afecten el resultado.

• No hace falta esperar respuesta para información no esencial; no es obligatorio elegir secciones detalladas antes de conocer las fuentes.

• Extrae con la habilidad adecuada y luego redacta según un tipo exacto de paper.

Reglas de coordinación

1. Recordatorio del idioma de entrada — responde en el mismo idioma que el usuario.
2. Indica claramente el resultado del archivo fuente: <nombre_original>.<extensión>. No sobrescribas archivos. Extensiones: documento .extract.md|.txt|.csv, resumen .digest.md, subtítulos .srt|.vtt, clip .clip-<t1>-<t2>.mp4, informe .report.md|.report.docx.
3. No importes entrada — solo procesa archivos reales, coloca los resultados en/sobre el archivo; no añadas archivos por tu cuenta.
4. Entrada web/redes sociales/búsqueda → que la habilidad web (Jina/agent-reach/exa) lea primero; entrada multimedia → habilidad media.
5. Contenido bloqueado (redes sociales, artículos de pago) → que la habilidad web (agent-reach/Jina) lo lea; no inicies sesión, no vulneres el bloqueo; informa al usuario si no se puede leer.
6. Cuando haya informe/archivo de informe (todo .report.docx): verifícalo según la habilidad paper — pdfinfo + pdftotext, no inventes.
7. La habilidad multimedia necesita fetch por sesión → consulta la habilidad media (sección fetch) o scripts/fetch-session.sh --list.
8. Local-first: prioriza herramientas locales para archivos locales. Web/API requieren conexión; si estás offline, usa solo fuentes locales/caché realmente disponibles o proporcionadas por el usuario, e indica las partes inaccesibles.
9. Siempre reporta el archivo escrito (nombre + ruta) — no guardes silencio.

Notación de flujo

En el diagrama siguiente, ▸ significa entrega al siguiente paso; → significa que el flujo continúa; los corchetes describen el tipo de fuente o resultado. Esto es notación de flujo, no etiquetas de fuente ni formato de salida.

Flujo de coordinación típico

PDF escaneado ▸ habilidad doc ▸ texto/tabla ▸ habilidad paper ▸ informe
URL web/red social ▸ habilidad web ▸ texto ▸ habilidad paper (si se necesita informe)
URL/archivo video ▸ habilidad media ▸ resumen + fotogramas ▸ habilidad paper (si se necesita informe)
SRT/mm:ss ▸ habilidad media ▸ recorte ▸ concatenación