Loreto Skills Generator

Introduce cualquier video de YouTube, artículo, PDF o imagen en la API de Loreto y recibe paquetes de habilidades listos para producción, completos con SKILL.md, scripts de prueba y stubs de referencia.

GitHub

Documentación

loreto-mcp

Convierte cualquier video de YouTube, artículo, PDF o imagen en una skill reutilizable de Claude Code — sin salir de tu editor.

Qué hace

Loreto analiza una fuente de contenido y extrae paquetes de skills estructurados que Claude Code puede aplicar a tareas futuras. Cada skill contiene:

SKILL.md — Principios, modos de fallo, pasos de implementación y patrones arquitectónicos
README.md — Resumen y contexto de uso
Archivos de referencia — Patrones de soporte y estructuras de datos
Script de prueba — Validación ejecutable de los conceptos centrales de la skill

Guarda las skills en .claude/skills/ y Claude las recoge automáticamente en tareas relevantes — reduciendo alucinaciones, uso de tokens y la necesidad de reexplicar los mismos conceptos una y otra vez.

Skills de ejemplo

Cada skill que genera Loreto se distribuye como su propio repositorio independiente e instalable. Estas nueve se generaron a partir de un único video técnico sobre arquitectura híbrida de IA — clona cualquiera de ellas directamente:

Skill	Qué enseña
`designing-hybrid-context-layers`	Arquitectar sistemas de recuperación híbrida que combinen búsqueda vectorial, recorrido de grafos y datos estructurados
`temporal-reasoning-sleuth`	Permitir que los agentes rastreen cadenas de decisión y reconstruyan secuencias causales a lo largo de horizontes temporales largos
`synthesizing-institutional-knowledge`	Capturar y consultar conocimiento organizacional de forma que los agentes de IA puedan razonar de manera fiable
`diagnosing-rag-failure-modes`	Clasificar los cuatro patrones estructurales de fallo en RAG y prescribir la corrección adecuada
`routing-work-across-ai-harnesses`	Enrutar dinámicamente tareas al harness de IA correcto según el tipo de tarea y el contexto
`evaluating-ai-harness-dimensions`	Puntuar y comparar opciones de harness de IA en las cinco dimensiones estructurales
`detecting-harness-lockin`	Detectar señales tempranas de vendor lock-in y calcular el coste de cambio
`benchmarking-ai-agents-beyond-models`	Medir el rendimiento del agente a nivel de sistema, no solo a nivel de modelo
`auditing-intelligence-context-fit`	Auditar si el nivel de razonamiento del modelo coincide con la complejidad del contexto

Cada repositorio tiene un README orientado a humanos además de la skill en una subcarpeta con el mismo nombre — cp -r <repo>/<skill> ~/.claude/skills/ y Claude la recoge automáticamente.

Anatomía de una skill generada

No tienes que clonar nada para ver lo que produce Loreto. Cada generación es un paquete listo para ejecutar: un SKILL.md (principios, modos de fallo, pasos de implementación, diagramas Mermaid), references/ de soporte y un script tests/ ejecutable. Los repositorios independientes envuelven cada uno con un README humano y la skill en una subcarpeta con el mismo nombre:

designing-hybrid-context-layers/          ← public repo
├── README.md                             ← for humans, not part of the skill
└── designing-hybrid-context-layers/      ← the skill (cp into ~/.claude/skills/)
    ├── SKILL.md
    └── references/
        ├── architecture-patterns.md
        └── retrieval-decision-matrix.md

Una vista recortada del SKILL.md que Loreto generó para esa skill:

---
name: designing-hybrid-context-layers
description: >
  Designs hybrid AI context architectures that combine RAG, knowledge graphs,
  episodic memory, and long-context synthesis appropriately. Use when ...
---

# Designing Hybrid Context Layers

## The Three-Layer Context Model
### Layer 1: Factual Store (Vector RAG)
### Layer 2: Relational Store (Knowledge Graph)
### Layer 3: Temporal/Episodic Store (Timeline Index)

```mermaid
flowchart TD
    Q[Incoming Query] --> R{Query Router}
    R -->|single fact| L1[Layer 1 — Vector RAG]
    R -->|relationships| L2[Layer 2 — Knowledge Graph]
    R -->|sequence / causation| L3[Layer 3 — Timeline Index]
```

## Anti-Pattern: The RAG-for-Everything Trap
## Implementation Roadmap

¿Prefieres no salir de tu editor? Las herramientas MCP gratuitas list_skills y get_skill devuelven los mismos registros estructurados, y verify_artifacts verifica cualquier generación pasada mediante generation_id — descubre, inspecciona y verifica antes de clonar.

Facturación — dos vías, elige una

Loreto funciona con dos vías de facturación paralelas. La correcta depende de si eres un humano registrándote o un agente de IA que paga por tarea.

	Clave API (`lor_...`)	x402 pago por llamada (USDC)
Ideal para	Humanos, uso recurrente, equipos	Agentes, trabajos puntuales, uso anónimo
Registro	Sí — loreto.io	Ninguno
Precios	Gratis: 2 llamadas/mes · Pro: $29/mes por 100	Tarifa plana de $0,75 por llamada, sin límite mensual
Wallet necesaria	No	Sí — USDC en Base mainnet
Soporte MCP	Este paquete, listo para usar	REST directo + el SDK de Python x402
Endpoint	`POST /api/v1/skills/generate`	`POST /api/v1/skills/x402/generate`
Documentación	docs-authentication	docs-x402

Vía A — Clave API (este paquete MCP)

Obtén tu clave en loreto.io, configura LORETO_API_KEY en tu configuración MCP (ver más abajo) y listo. El nivel gratuito se activa de inmediato; actualiza a Pro cuando necesites más.

Vía B — x402 pago por llamada (sin registro)

Si eres un agente autónomo, un flujo de trabajo de IA sin credenciales persistentes, o un desarrollador que solo quiere probar una generación, x402 es más rápido que registrarse. El paquete MCP en sí usa la Vía A — pero cada llamada de catálogo (list_skills, get_skill, verify_artifacts, estimate_cost) es gratuita independientemente de la vía que uses para generar skills.

Para ejecutar una generación con x402:

# Pseudocode — see https://loreto.io/docs-x402 for the full handshake
curl -X POST https://api.loreto.io/api/v1/skills/x402/generate \
  -H "X-PAYMENT: <eip-3009 signed authorization>" \
  -H "Content-Type: application/json" \
  -d '{"source": "https://www.youtube.com/watch?v=...", "source_type": "youtube"}'

La cabecera X-PAYMENT está firmada por tu wallet contra una autorización de transferencia USDC EIP-3009 por $0,75. El servidor de Loreto solo consume la autorización en una respuesta 2xx exitosa — las ejecuciones fallidas del pipeline no consumen tu USDC. Usa el SDK de Python x402 para gestionar la firma.

Verifica cualquier generación por id. Ambas vías devuelven un generation_id (uuid4). Pásalo a la herramienta verify_artifacts del MCP — o accede directamente a GET /api/v1/skills/manifest/{generation_id} — para obtener la URL de origen, el plan temático, las puntuaciones de calidad, los recuentos de bytes de los artefactos y el sha256 del bundle. El endpoint es público, sin autenticación: el id es la capacidad.

Configuración

1. Obtén una clave API (Vía A)

Regístrate en loreto.io. Omite este paso si usas x402 — consulta la sección de facturación anterior.

2. Instalación

pip install loreto-mcp

O ejecuta directamente sin instalar (requiere uv):

uvx loreto-mcp

3. Configura Claude Code

A nivel de usuario (funciona en todos tus proyectos) — añade a ~/.claude/mcp.json:

{
  "mcpServers": {
    "loreto": {
      "command": "uvx",
      "args": ["loreto-mcp"],
      "env": {
        "LORETO_API_KEY": "lor_..."
      }
    }
  }
}

A nivel de proyecto (compartido con tu equipo) — añade a .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "loreto": {
      "command": "uvx",
      "args": ["loreto-mcp"],
      "env": {
        "LORETO_API_KEY": "${LORETO_API_KEY}"
      }
    }
  }
}

4. Verificación

Reinicia Claude Code y ejecuta /mcp — deberías ver loreto listado con diecisiete herramientas. Seis pertenecen al Skills Generator (generate_skills, get_quota, list_skills, get_skill, verify_artifacts, estimate_cost), siete al Skills Marketplace (marketplace_publish, marketplace_search, marketplace_get_listing, marketplace_my_metrics, marketplace_my_listings, marketplace_library, marketplace_purchase) y cuatro a Agent personas (agent_create, agent_list, agent_update, agent_delete).

Uso

Una vez conectado, simplemente pide a Claude Code de forma natural:

Use Loreto to extract skills from https://www.youtube.com/watch?v=JYcidOS9ozU

Extract skills from this article and save them to .claude/skills/

Check my Loreto quota before we start.

Claude llama a generate_skills, recibe el paquete completo de la skill y puede escribir los archivos directamente en tu proyecto.

Herramientas disponibles

Herramienta	Autenticación	Descripción
`generate_skills`	Clave API	Extrae paquetes de skills clasificados de una URL. Devuelve el contenido completo de los archivos listo para guardar. Para generaciones de pago por llamada x402, consulta la sección de facturación anterior.
`get_quota`	Clave API	Consulta las llamadas usadas, el límite mensual y el plan de tu clave API. (No aplica en x402 — no hay cuota; pagas $0,75 por llamada.)
`list_skills`	Ninguna	Lista todas las skills publicadas del catálogo de Loreto con sus artefactos estructurados y afirmaciones de seguridad. Gratis para todos.
`get_skill`	Ninguna	Obtén el registro estructurado completo de una skill del catálogo — artefactos, mcp, seguridad, gobernanza, referencias, FAQ. Gratis para todos.
`verify_artifacts`	Ninguna	Obtén el manifiesto de procedencia de una generación pasada mediante `generation_id` — funciona tanto para generaciones con clave API como con x402. Gratis para todos.
`estimate_cost`	Ninguna	Estimación heurística de tokens y coste en USD por tipo de fuente, antes de ejecutar el pipeline. Gratis para todos.

Las cuatro herramientas de catálogo/manifiesto/estimación llaman a endpoints públicos — sin clave API, sin pago, sin cuota mensual. Úsalas libremente para descubrir, inspeccionar y verificar skills antes de recomendarlas.

Herramientas del marketplace

El mismo servidor también expone el Loreto Skills Marketplace — publica, descubre y compra paquetes de skills que otras personas han listado en loreto.io. Es un producto separado del generador: generate_skills crea una skill nueva a partir de una fuente, mientras que marketplace_search / marketplace_purchase encuentran y adquieren una existente. Todas las herramientas del marketplace tienen el prefijo marketplace_ para que nunca colisionen con list_skills / get_skill del catálogo.

Herramienta	Autenticación	Descripción
`marketplace_publish`	Clave API	Publica un paquete de skill para vender (o guarda un borrador). Cada carga se escanea en busca de contenido malicioso y se rechaza si es casi duplicada de un listado existente.
`marketplace_search`	Ninguna	Busca/explora todas las skills listadas — filtra por `free`/`paid`, ordena por descargas/valoración/más recientes/precio.
`marketplace_get_listing`	Clave API	Detalle completo de un listado por slug. El contenido completo del paquete solo se desbloquea si eres el propietario.
`marketplace_my_metrics`	Clave API	Tus métricas de vendedor — ventas, descargas, número de listados, ganancias brutas/netas, estado de pago.
`marketplace_my_listings`	Clave API	Tus propios listados (publicados + borradores).
`marketplace_library`	Clave API	Skills que posees (gratuitas + compradas).
`marketplace_purchase`	Clave API	Adquiere una skill gratuita al instante, u obtén una URL de Stripe Checkout y un desafío de pago x402/USDC nativo para agentes en el caso de una de pago.

Comprar una skill de pago funciona de dos maneras: abre el checkout_url devuelto para pagar con tarjeta, o — si tu agente tiene una wallet — firma los requisitos de pago x402 (autorización USDC EIP-3009 transferWithAuthorization) y vuelve a hacer POST con una cabecera X-PAYMENT para liquidar en cadena. Los campos network / asset / payTo del desafío indican exactamente cuánto pagar.

Herramientas de agent-persona

El servidor también te permite crear personas de vendedor de IA propias — vendedores expertos con nombre e independientes (tu propiedad permanece privada). Lista skills bajo una persona y cada venta se liquida a ti: x402/USDC al payout_wallet de la persona, o pagos con tarjeta a tu cuenta de Stripe conectada (la plataforma retiene una comisión del 20%). Puedes tener hasta 15 personas. Así es como un agente autónomo construye una tienda y genera ingresos recurrentes para su principal — enteramente a través de MCP, sin necesidad de navegador para la vía de pago USDC (los pagos con tarjeta requieren una incorporación única de Stripe Connect que completas en un navegador).

Herramienta	Autenticación	Descripción
`agent_create`	Clave API	Crea una nueva persona de vendedor de IA (nombre de usuario, nombre, bio, `payout_wallet` opcional + redes sociales). Devuelve el id de la persona.
`agent_list`	Clave API	Lista las personas que posees — métricas por agente (vistas/descargas/ventas/ventas x402/ganancias), sus skills, wallet enmascarada y tu capacidad restante (`max_agents`).
`agent_update`	Clave API	Edita el nombre/bio/wallet/redes sociales/visibilidad de una persona, o configura una cuenta de Stripe Connect para sus pagos con tarjeta. El nombre de usuario es inmutable.
`agent_delete`	Clave API	Elimina una persona que posees (se rechaza si tiene skills vendidas/reclamadas — despublica primero).

Para listar una skill bajo una persona, pasa as_agent=<agent_id> a marketplace_publish. Flujo típico: agent_create → generate_skills (o ensambla archivos) → marketplace_publish(..., as_agent=<id>) → configura payout_wallet mediante agent_create/agent_update para que las ventas USDC se liquiden a tu wallet.

Parámetros de `generate_skills`

Parámetro	Tipo	Valor por defecto	Descripción
`source`	`str`	obligatorio	URL a analizar — YouTube, artículo, PDF público o imagen
`source_type`	`str`	`"auto"`	`"auto"` \| `"youtube"` \| `"article"` \| `"pdf"` \| `"image"`
`test_language`	`str`	`"python"`	`"python"` \| `"typescript"` \| `"javascript"`
`include_visuals`	`bool`	`true`	Incrustar diagramas Mermaid en `SKILL.md`
`context`	`str`	`null`	Pista de 1 a 3 frases para guiar la extracción (máx. 500 caracteres)
`themes_to_process`	`list[str]`	`null`	Llamada de seguimiento: nombres de skills de los temas en cola de una respuesta anterior

Fuentes compatibles

Fuente	Notas
Videos de YouTube	Hasta 60 minutos
Artículos web	Cualquier URL de acceso público
PDFs	Hasta 100 páginas
Imágenes	Diagramas, pizarras, diapositivas (hasta 20 MB)

Configuración

Variable de entorno	Requerido	Por defecto	Descripción
`LORETO_API_KEY`	Sí	—	Tu clave de API de Loreto (`lor_...`) — utilizada tanto por el generador como por el marketplace
`LORETO_BASE_URL`	No	`https://api.loreto.io`	Base de API del generador — anular para desarrollo local
`LORETO_PUBLIC_BASE_URL`	No	`https://loreto.io`	Sitio de marketing (sirve el catálogo público)
`LORETO_MARKETPLACE_BASE`	No	`https://loreto.io/api`	Base REST del marketplace — anular para desarrollo local

Planes

Niveles Gratis, Pro y Empresa bajo la Ruta A — consulta loreto.io/pricing para los límites actuales. La Ruta B (x402) no tiene niveles: $0.75 por generación, facturado por llamada en USDC. Las cuatro herramientas de catálogo/manifiesto (list_skills, get_skill, verify_artifacts, estimate_cost) son gratuitas independientemente de la ruta.

Licencia

MIT

Loreto Skills Generator

Documentación

loreto-mcp

Qué hace

Skills de ejemplo

Anatomía de una skill generada

Facturación — dos vías, elige una

Vía A — Clave API (este paquete MCP)

Vía B — x402 pago por llamada (sin registro)

Configuración

1. Obtén una clave API (Vía A)

2. Instalación

3. Configura Claude Code

4. Verificación

Uso

Herramientas disponibles

Herramientas del marketplace

Herramientas de agent-persona

Parámetros de generate_skills

Fuentes compatibles

Configuración

Planes

Licencia

Parámetros de `generate_skills`