DETENTE. LEE TODO ESTE SKILL.MD ANTES DE LLAMAR A CUALQUIER ENDPOINT.
Skill arXiv
Busca en arXiv y extrae conocimiento en memoria.
Comandos
| Comando | Descripción |
|---|---|
search | Encuentra artículos (devuelve resúmenes para triaje) |
learn | Extrae conocimiento en memoria |
download | Descarga el HTML del artículo por defecto; los archivos de salida se nombran a partir del título del artículo |
OBLIGATORIO: Generación de Contexto Dinámico
NO NEGOCIABLE: Antes de CUALQUIER operación arxiv, el agente DEBE generar un archivo de contexto dinámico que capture los objetivos de colaboración actuales.
Por qué es necesario
Sin contexto dinámico:
- La búsqueda devuelve artículos tangencialmente relacionados
- El triaje de resúmenes carece de criterios de relevancia claros
- El conocimiento extraído es genérico ("¿Qué dice el artículo sobre X?")
Con contexto dinámico:
- La búsqueda se orienta a necesidades de implementación específicas
- La evaluación de resúmenes tiene criterios claros de aceptación/rechazo
- El conocimiento extraído es procesable ("¿Cómo implementar X como código?")
Flujo de Trabajo: Descubrimiento de Artículos con Contexto Primero
0. CONTEXTO → Generar contexto dinámico a partir de la conversación (REQUERIDO)
1. BÚSQUEDA → Usar el contexto para encontrar artículos relevantes
2. TRIAJE → Evaluar resúmenes contra los objetivos del contexto
3. DECIDE → El usuario elige qué artículos extraer
4. APRENDER → Extraer con contexto para fragmentos de conocimiento enfocados
Paso 0: Generar Contexto Dinámico (REQUERIDO)
Antes de buscar, el agente DEBE crear /tmp/arxiv_context.md con:
# Contexto de Investigación: [Tu Objetivo Específico]
## Qué Estamos Construyendo
[Describe el sistema/característica específica, ej., "Teoría de la Mente para el agente Horus"]
## Estado Actual
[Lo que ya existe, lo que está implementado, lo que tenemos]
## Qué Necesitamos de los Artículos
1. [Pregunta específica 1, ej., "Cómo representar la confianza en las creencias como estructura de datos"]
2. [Pregunta específica 2, ej., "Cuándo activar la reflexión contrafáctica"]
3. [Pregunta específica 3, ej., "Algoritmo para actualizar creencias en caso de contradicción"]
## Términos de Búsqueda a Probar
- [término 1]
- [término 2]
## Criterios de Relevancia para el Triaje de Resúmenes
- ALTA: Artículos que abordan directamente [necesidad específica]
- MEDIA: Artículos con técnicas relacionadas que podrían adaptarse
- BAJA: Tangencialmente relacionados, omitir a menos que no haya nada mejor
## Enfoque de Extracción de Conocimiento
- Extraer: [qué tipo de conocimiento, ej., "algoritmos, estructuras de datos, reglas de actualización"]
- Omitir: [qué ignorar, ej., "métricas de evaluación, descripciones de conjuntos de datos, trabajo futuro"]
## Preferencia de Formato de Salida
Formular como problemas de implementación, no resúmenes:
- MALO: "¿Qué dice el artículo sobre X?"
- BUENO: "¿Cómo deberíamos implementar X? ¿Qué patrón de código?"
Paso 1: Buscar con Contexto
Después de crear el contexto, úsalo para guiar la búsqueda:
# Búsqueda guiada por los objetivos del contexto
./run.sh search -q "theory of mind BDI agent belief tracking" -n 10
Paso 2: Triaje Contra el Contexto
Evalúa cada resumen contra los criterios de relevancia del contexto:
## Artículos Encontrados - Evaluación Contra Objetivos del Contexto
### 1. **Título del Artículo** (arXiv:XXXX.XXXXX)
> [Resumen]
**Contra el contexto:**
- Aborda el objetivo 1 (representación de creencias): SÍ - describe la estructura de diccionario BDI
- Aborda el objetivo 2 (reflexión contrafáctica): NO
- **Veredicto: ALTA** - responde directamente a nuestra pregunta sobre estructura de datos
### 2. **Título del Artículo** (arXiv:XXXX.XXXXX)
> [Resumen]
**Contra el contexto:**
- Aborda el objetivo 1: NO
- Aborda el objetivo 2: SÍ - describe las condiciones de activación de la reflexión
- **Veredicto: ALTA** - responde directamente a nuestra pregunta sobre algoritmo
---
¿Qué artículos debería extraer?
Paso 3: Extraer con el Archivo de Contexto
Pasa el archivo de contexto a learn para una extracción enfocada:
./run.sh learn 2501.15355 --scope persona-research --context-file /tmp/arxiv_context.md
NO procedas sin confirmación del usuario sobre la selección de artículos.
search - Encontrar Artículos
./run.sh search -q "agent memory" -n 5
Devuelve artículos con resúmenes completos para un triaje rápido.
| Opción | Descripción |
|---|---|
-q | Consulta de búsqueda (requerida) |
-n | Máximo de resultados (por defecto: 10) |
-c | Filtro de categoría (ej., cs.LG) |
-m | Artículos de los últimos N meses |
--smart | El LLM traduce la consulta a lenguaje natural |
learn - Extraer Conocimiento
./run.sh learn 2601.08058 --scope memory
Flujo completo: descargar → perfilar → extraer → Q&A → entrevista → almacenar → verificar bordes.
| Opción | Descripción |
|---|---|
--scope | Ámbito de memoria (requerido) |
--context | Enfoque de dominio para la relevancia |
--dry-run | Vista previa sin almacenar |
--skip-interview | Aceptar recomendaciones automáticamente |
--accurate | Forzar extracción con PDF + VLM |
--mode | Modo de entrevista: auto, html, tui (por defecto: auto) |
Modo de Extracción (HTML-Primero)
NUEVO: El comando learn ahora utiliza extracción basada en HTML por defecto:
- Descarga HTML de ar5iv.org (artículos arXiv convertidos a HTML limpio)
- Ejecuta una verificación rápida de perfil (cuenta figuras/tablas)
- Enruta al modo de extracción apropiado
arxiv learn <id>
│
├── modo rápido (por defecto) ──► HTML de ar5iv ──► extractor HTML
│ - La mayoría de artículos de investigación (100% de paridad de extracción)
│ - Contenido con mucho texto (sin problemas de columnas PDF)
│
└── modo exacto ──► PDF de arxiv ──► extractor PDF + VLM
- Artículos donde las figuras son críticas
- Tablas complejas con valores precisos
- Usar: indicador --accurate
¿Por qué HTML-Primero?
| Aspecto | HTML (ar5iv) | |
|---|---|---|
| Calidad de extracción | 100% de paridad | ~87% (problemas de detección de columnas) |
| Velocidad | Rápida (~5s) | Más lenta (~30s-2min) |
| Leyendas de figuras | Incluidas | Requiere VLM |
| Renderizado matemático | MathML preservado | Aproximación de texto |
| Problemas de diseño | Ninguno | Problemas de detección de columnas dobles |
ar5iv.org convierte la fuente LaTeX de arXiv a HTML semántico con ecuaciones MathML y estructura adecuada. Esto elimina los problemas de extracción de PDF.
Cuándo Usar --accurate
| Tipo de Contenido | Modo Recomendado | Por qué |
|---|---|---|
| La mayoría de artículos de investigación | por defecto (HTML) | El texto + las leyendas son suficientes |
| Artículos de revisión | por defecto (HTML) | Cobertura amplia, figuras exactas no críticas |
| Artículos con diagramas críticos | --accurate | Cuando el contenido visual es el punto |
| Artículos con tablas de datos complejas | --accurate | Cuando los números precisos importan |
# Por defecto: Extracción HTML (rápida, confiable)
./run.sh learn 2601.10025 --scope persona-research
# Forzar modo exacto para artículos con muchas figuras
./run.sh learn 2501.15355 --scope tom-research --accurate
Enrutamiento Basado en Perfil
El skill perfila automáticamente el HTML descargado para sugerir el modo de extracción:
- < 20 figuras Y < 10 tablas: Usa HTML (modo rápido)
- > 20 figuras O > 10 tablas: Sugiere modo exacto (o usa
--accurate)
La salida del perfil se muestra en los registros:
Perfil: 12 figuras, 4 tablas → Usando extracción HTML (modo rápido)
Ruta Feliz
# 1. Buscar - obtener resúmenes
./run.sh search -q "agent memory systems" -n 5
# 2. DETENERSE - discutir resúmenes con el usuario, evaluar relevancia
# 3. Aprender - extraer artículos seleccionados por el usuario (extracción HTML por defecto)
./run.sh learn 2601.10702 --scope memory --context "agent systems"
Ejemplos
Revisión de Investigación (extracción HTML - por defecto)
./run.sh learn 2601.10025 --scope persona-research --context "LLM personality"
Artículo con Figuras Críticas (modo exacto)
./run.sh learn 2501.15355 --scope tom-research --context "BDI architecture" --accurate
Prueba en Seco Primero
# Vista previa de lo que se extraería
./run.sh learn 2601.10025 --scope test --dry-run
Descargar Solo HTML
# Descargar HTML de ar5iv para inspección manual (por defecto; nombre de archivo basado en título)
./run.sh download -i 2501.15355
# Descargar PDF solo cuando sea necesario
./run.sh download -i 2501.15355 --format pdf
Procesamiento por Lotes (Paralelo)
# Procesar múltiples artículos en paralelo (por defecto: 2 concurrentes)
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope tom-research --context-file /tmp/context.md
# Aumentar paralelismo para un procesamiento más rápido
./run.sh batch 2501.15355 2502.14171 2310.10701 --scope research --parallel 3
# Prueba en seco para vista previa
./run.sh batch 2501.15355 2502.14171 --scope test --dry-run
| Opción | Descripción |
|---|---|
--parallel N | Máximo de artículos a procesar concurrentemente (por defecto: 2) |
--context-file | Archivo de contexto enriquecido para extracción enfocada |
--skip-interview | Aceptación automática (por defecto para lotes) |
--dry-run | Vista previa sin almacenar |
Nota: El paralelismo recomendado es de 2-3 artículos. Valores más altos pueden alcanzar límites de tasa de API.
Errores Comunes
INCORRECTO: Buscar sin crear contexto primero
./run.sh search -q "agent memory" -n 10
CORRECTO: Generar /tmp/arxiv_context.md LUEGO buscar
# 1. Escribir archivo de contexto con objetivos específicos y criterios de relevancia
# 2. Luego buscar guiado por el contexto
./run.sh search -q "agent memory BDI belief tracking" -n 10
INCORRECTO: Extraer artículos sin confirmación del usuario
# El agente extrae automáticamente los 10 resultados de búsqueda
./run.sh learn 2501.15355 --scope research
./run.sh learn 2502.14171 --scope research
CORRECTO: Presentar resúmenes, dejar que el usuario elija, luego extraer
./run.sh search -q "agent memory" -n 10
# DETENERSE - discutir resúmenes con el usuario, evaluar relevancia
# El usuario elige los artículos 2 y 5
./run.sh learn 2501.15355 --scope research --context-file /tmp/arxiv_context.md
INCORRECTO: Usar --accurate para artículos con mucho texto
./run.sh learn 2601.10025 --scope research --accurate # pierde tiempo en extracción PDF
CORRECTO: Modo HTML por defecto para la mayoría de artículos, --accurate solo para aquellos con muchas figuras
./run.sh learn 2601.10025 --scope research # HTML es más rápido y confiable
Dependencias
| Componente | URL | Propósito |
|---|---|---|
| ar5iv.org | https://ar5iv.org | Conversión de LaTeX a HTML para artículos arXiv |
| skill extractor | (skill hermano) | Extracción de contenido HTML/PDF |
| skill qra | (skill hermano) | Generación de pares de Q&A a partir de texto |
Nota de recuperación de fallos en entrenamiento QRA (2026-09-14)
Observado durante investigación de entrenamiento qra: download --format html fallaba cuando
la API de metadatos de arXiv devolvía 429 o se agotaba el tiempo de espera antes del paso de descarga HTML/PDF.
El CLI ahora trata la búsqueda de metadatos como opcional para IDs de artículos directos. Si los metadatos
fallan, construye URLs de respaldo directas e intenta, en orden:
https://arxiv.org/html/<id-con-versión>https://arxiv.org/html/<id-base>https://ar5iv.org/abs/<id-base>https://ar5iv.labs.arxiv.org/html/<id-base>
Un fallo de metadatos debe aparecer en warnings[], no en errors[], cuando una de esas
URLs de contenido tiene éxito.