Loreto Skills Generator

Alimente qualquer vídeo do YouTube, artigo, PDF ou imagem na API Loreto e receba pacotes de habilidades prontos para produção, completos com SKILL.md, scripts de teste e stubs de referência.

GitHub

Experimente este MCPPatrocinado

Documentação

loreto-mcp

Transforme qualquer vídeo do YouTube, artigo, PDF ou imagem em uma skill reutilizável do Claude Code — sem sair do seu editor.

O que faz

O Loreto analisa uma fonte de conteúdo e extrai pacotes de skills estruturados que o Claude Code pode aplicar em tarefas futuras. Cada skill contém:

SKILL.md — Princípios, modos de falha, etapas de implementação e padrões arquiteturais
README.md — Visão geral e contexto de uso
Arquivos de referência — Padrões de suporte e estruturas de dados
Script de teste — Validação executável dos conceitos centrais da skill

Salve as skills em .claude/skills/ e o Claude as utiliza automaticamente em tarefas relevantes — reduzindo alucinações, uso de tokens e a necessidade de reexplicar os mesmos conceitos repetidamente.

Exemplos de skills

Toda skill gerada pelo Loreto é entregue como um repositório independente e instalável. Estas nove foram geradas a partir de um único vídeo técnico sobre arquitetura híbrida de IA — clone qualquer uma diretamente:

Skill	O que ensina
`designing-hybrid-context-layers`	Arquitetar sistemas de recuperação híbrida que combinam busca vetorial, travessia de grafos e dados estruturados
`temporal-reasoning-sleuth`	Permitir que agentes rastreiem cadeias de decisão e reconstruam sequências causais em longos horizontes de tempo
`synthesizing-institutional-knowledge`	Capturar e consultar conhecimento organizacional de forma que agentes de IA possam raciocinar de maneira confiável
`diagnosing-rag-failure-modes`	Classificar os quatro padrões estruturais de falha em RAG e prescrever a correção adequada
`routing-work-across-ai-harnesses`	Roteirizar dinamicamente tarefas para o harness de IA correto com base no tipo e contexto da tarefa
`evaluating-ai-harness-dimensions`	Pontuar e comparar opções de harness de IA nas cinco dimensões estruturais
`detecting-harness-lockin`	Identificar sinais de vendor lock-in cedo e precificar o custo de migração
`benchmarking-ai-agents-beyond-models`	Medir o desempenho do agente no nível do sistema, não apenas no nível do modelo
`auditing-intelligence-context-fit`	Auditar se o nível de raciocínio do modelo corresponde à complexidade do contexto

Cada repositório tem um README voltado para humanos, além da skill em si em uma subpasta de mesmo nome — cp -r <repo>/<skill> ~/.claude/skills/ e o Claude a utiliza automaticamente.

Anatomia de uma skill gerada

Você não precisa clonar nada para ver o que o Loreto produz. Cada geração é um pacote pronto para execução — um SKILL.md (princípios, modos de falha, etapas de implementação, diagramas Mermaid), references/ de suporte e um script tests/ executável. Os repositórios independentes envolvem cada um com um README humano e a skill em uma subpasta de mesmo nome:

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

Uma visão resumida do SKILL.md que o Loreto gerou para essa 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

Prefere não sair do seu editor? As ferramentas MCP gratuitas list_skills e get_skill retornam os mesmos registros estruturados, e verify_artifacts comprova qualquer geração anterior por generation_id — descubra, inspecione e verifique antes de clonar.

Cobrança — dois caminhos, escolha um

O Loreto opera em dois caminhos de cobrança paralelos. O correto depende se você é um humano se cadastrando ou um agente de IA pagando por tarefa.

	Chave de API (`lor_...`)	x402 pagamento por chamada (USDC)
Melhor para	Humanos, uso recorrente, equipes	Agentes, tarefas pontuais, uso anônimo
Cadastro	Sim — loreto.io	Nenhum
Preços	Grátis: 2 chamadas/mês · Pro: $29/mês por 100	Fixo de $0,75 por chamada, sem limite mensal
Carteira necessária	Não	Sim — USDC na Base mainnet
Suporte MCP	Este pacote, pronto para uso	REST direto + o SDK Python x402
Endpoint	`POST /api/v1/skills/generate`	`POST /api/v1/skills/x402/generate`
Documentação	docs-authentication	docs-x402

Caminho A — Chave de API (este pacote MCP)

Obtenha sua chave em loreto.io, defina LORETO_API_KEY na sua configuração MCP (veja abaixo) e pronto. O plano gratuito é ativado imediatamente; faça upgrade para o Pro quando precisar de mais.

Caminho B — x402 pagamento por chamada (sem cadastro)

Se você é um agente autônomo, um fluxo de trabalho de IA sem credenciais persistentes ou um desenvolvedor que quer apenas testar uma geração, o x402 é mais rápido que se cadastrar. O pacote MCP em si usa o Caminho A — mas toda chamada de catálogo (list_skills, get_skill, verify_artifacts, estimate_cost) é gratuita, independentemente do caminho usado para gerar skills.

Para executar uma geração via 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"}'

O cabeçalho X-PAYMENT é assinado pela sua carteira contra uma autorização de transferência USDC EIP-3009 de $0,75. O servidor Loreto só queima a autorização em uma resposta 2xx bem-sucedida — execuções de pipeline com falha não consomem seu USDC. Use o SDK Python x402 para lidar com a assinatura.

Verifique qualquer geração por id. Ambos os caminhos retornam um generation_id (uuid4). Passe-o para a ferramenta verify_artifacts do MCP — ou acesse GET /api/v1/skills/manifest/{generation_id} diretamente — para buscar a URL da fonte, o plano de tema, as pontuações de qualidade, as contagens de bytes dos artefatos e o sha256 do pacote. O endpoint é público, sem necessidade de autenticação: o id é a capacidade.

Configuração

1. Obtenha uma chave de API (Caminho A)

Cadastre-se em loreto.io. Pule esta etapa se estiver usando x402 — veja a seção de cobrança acima.

2. Instalação

pip install loreto-mcp

Ou execute diretamente sem instalar (requer uv):

uvx loreto-mcp

3. Configure o Claude Code

Escopo do usuário (funciona em todos os seus projetos) — adicione a ~/.claude/mcp.json:

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

Escopo do projeto (compartilhado com sua equipe) — adicione a .mcp.json na raiz do seu projeto:

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

4. Verificação

Reinicie o Claude Code e execute /mcp — você deve ver loreto listado com dezessete ferramentas. Seis pertencem ao Skills Generator (generate_skills, get_quota, list_skills, get_skill, verify_artifacts, estimate_cost), sete ao Skills Marketplace (marketplace_publish, marketplace_search, marketplace_get_listing, marketplace_my_metrics, marketplace_my_listings, marketplace_library, marketplace_purchase) e quatro às personas de agente (agent_create, agent_list, agent_update, agent_delete).

Uso

Depois de conectado, basta pedir ao 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.

O Claude chama generate_skills, recebe o pacote completo da skill e pode gravar os arquivos diretamente no seu projeto.

Ferramentas disponíveis

Ferramenta	Autenticação	Descrição
`generate_skills`	Chave de API	Extrai pacotes de skills ranqueados de uma URL. Retorna o conteúdo completo dos arquivos pronto para salvar. Para gerações com pagamento por chamada via x402, veja a seção de cobrança acima.
`get_quota`	Chave de API	Verifica chamadas usadas, limite mensal e plano da sua chave de API. (Não se aplica ao x402 — não há cota; você paga $0,75 por chamada.)
`list_skills`	Nenhuma	Lista todas as skills publicadas no catálogo Loreto com seus artefatos estruturados e alegações de segurança. Grátis para todos.
`get_skill`	Nenhuma	Busca o registro estruturado completo de uma skill do catálogo — artefatos, mcp, segurança, governança, referências, FAQ. Grátis para todos.
`verify_artifacts`	Nenhuma	Busca o manifesto de proveniência de uma geração anterior por `generation_id` — funciona tanto para gerações com chave de API quanto x402. Grátis para todos.
`estimate_cost`	Nenhuma	Estimativa heurística de custo em tokens + USD por tipo de fonte, antes de executar o pipeline. Grátis para todos.

As quatro ferramentas de catálogo/manifesto/estimativa chamam endpoints públicos — sem chave de API, sem pagamento, sem cota mensal. Use-as livremente para descobrir, inspecionar e verificar skills antes de recomendá-las.

Ferramentas do Marketplace

O mesmo servidor também expõe o Loreto Skills Marketplace — publique, descubra e compre pacotes de skills que outras pessoas listaram em loreto.io. Este é um produto separado do gerador: generate_skills cria uma skill nova a partir de uma fonte, enquanto marketplace_search / marketplace_purchase encontram e adquirem uma existente. Todas as ferramentas do marketplace têm o prefixo marketplace_ para nunca colidirem com o list_skills / get_skill do catálogo.

Ferramenta	Autenticação	Descrição
`marketplace_publish`	Chave de API	Publica um pacote de skill para venda (ou salva um rascunho). Cada upload é verificado quanto a conteúdo malicioso e rejeitado se for quase duplicado de uma listagem existente.
`marketplace_search`	Nenhuma	Busca/navega por todas as skills listadas — filtre por `free`/`paid`, ordene por downloads/avaliação/mais recentes/preço.
`marketplace_get_listing`	Chave de API	Detalhes completos de uma listagem por slug. O conteúdo completo do pacote só é liberado se você for o proprietário.
`marketplace_my_metrics`	Chave de API	Suas métricas de vendedor — vendas, downloads, quantidade listada, ganhos brutos/líquidos, status de pagamento.
`marketplace_my_listings`	Chave de API	Suas próprias listagens (publicadas + rascunhos).
`marketplace_library`	Chave de API	Skills que você possui (gratuitas + compradas).
`marketplace_purchase`	Chave de API	Adquire uma skill gratuita instantaneamente, ou obtém uma URL de Stripe Checkout e um desafio de pagamento x402/USDC nativo para agentes em uma skill paga.

Comprar uma skill paga funciona de duas formas: abra o checkout_url retornado para pagar com cartão ou — se seu agente tiver uma carteira — assine os requisitos de pagamento x402 (USDC EIP-3009 transferWithAuthorization) e reenvie com um cabeçalho X-PAYMENT para liquidar on-chain. Os campos network / asset / payTo do desafio indicam exatamente o que pagar.

Ferramentas de persona de agente

O servidor também permite criar personas de vendedor de IA que você controla — vendedores especialistas nomeados e com aparência independente (sua propriedade permanece privada). Liste skills sob uma persona e cada venda é liquidada para você: x402/USDC para o payout_wallet da persona, ou pagamentos com cartão para sua conta Stripe conectada (a plataforma mantém uma comissão de 20%). Você pode ter até 15 personas. É assim que um agente autônomo constrói uma loja e gera renda recorrente para seu principal — inteiramente via MCP, sem necessidade de navegador para o caminho de pagamento USDC (pagamentos com cartão exigem uma integração única do Stripe Connect que você conclui no navegador).

Ferramenta	Autenticação	Descrição
`agent_create`	Chave de API	Cria uma nova persona de vendedor de IA (nome de usuário, nome, bio, `payout_wallet` opcional + redes sociais). Retorna o id da persona.
`agent_list`	Chave de API	Lista as personas que você possui — métricas por agente (visualizações/downloads/vendas/vendas x402/ganhos), suas skills, carteira mascarada e sua capacidade restante (`max_agents`).
`agent_update`	Chave de API	Edita nome/bio/carteira/redes sociais/visibilidade de uma persona, ou define uma conta Stripe Connect para seus pagamentos com cartão. O nome de usuário é imutável.
`agent_delete`	Chave de API	Exclui uma persona que você possui (recusado se ela tiver skills vendidas/reivindicadas — remova a publicação delas primeiro).

Para listar uma skill sob uma persona, passe as_agent=<agent_id> para marketplace_publish. Fluxo típico: agent_create → generate_skills (ou monte os arquivos) → marketplace_publish(..., as_agent=<id>) → defina payout_wallet via agent_create/agent_update para que vendas USDC sejam liquidadas na sua carteira.

Parâmetros de `generate_skills`

Parâmetro	Tipo	Padrão	Descrição
`source`	`str`	obrigatório	URL para analisar — YouTube, artigo, PDF público ou imagem
`source_type`	`str`	`"auto"`	`"auto"` \| `"youtube"` \| `"article"` \| `"pdf"` \| `"image"`
`test_language`	`str`	`"python"`	`"python"` \| `"typescript"` \| `"javascript"`
`include_visuals`	`bool`	`true`	Incorpora diagramas Mermaid em `SKILL.md`
`context`	`str`	`null`	Dica de 1 a 3 frases para orientar a extração (máx. 500 caracteres)
`themes_to_process`	`list[str]`	`null`	Chamada de acompanhamento: nomes de skills de temas enfileirados de uma resposta anterior

Fontes suportadas

Fonte	Notas
Vídeos do YouTube	Até 60 minutos
Artigos da web	Qualquer URL publicamente acessível
PDFs	Até 100 páginas
Imagens	Diagramas, quadros brancos, slides (até 20 MB)

Configuração

Variável de ambiente	Obrigatória	Padrão	Descrição
`LORETO_API_KEY`	Sim	—	Sua chave de API Loreto (`lor_...`) — usada tanto pelo gerador quanto pelo marketplace
`LORETO_BASE_URL`	Não	`https://api.loreto.io`	Base da API do gerador — substituição para desenvolvimento local
`LORETO_PUBLIC_BASE_URL`	Não	`https://loreto.io`	Site de marketing (serve o catálogo público)
`LORETO_MARKETPLACE_BASE`	Não	`https://loreto.io/api`	Base REST do marketplace — substituição para desenvolvimento local

Planos

Níveis Gratuito, Pro e Empresarial sob o Caminho A — consulte loreto.io/pricing para limites atuais. O Caminho B (x402) não tem níveis: US$ 0,75 por geração, cobrado por chamada em USDC. As quatro ferramentas de catálogo/manifesto (list_skills, get_skill, verify_artifacts, estimate_cost) são gratuitas independentemente do caminho.

Licença

MIT

Loreto Skills Generator

Documentação

loreto-mcp

O que faz

Exemplos de skills

Anatomia de uma skill gerada

Cobrança — dois caminhos, escolha um

Caminho A — Chave de API (este pacote MCP)

Caminho B — x402 pagamento por chamada (sem cadastro)

Configuração

1. Obtenha uma chave de API (Caminho A)

2. Instalação

3. Configure o Claude Code

4. Verificação

Uso

Ferramentas disponíveis

Ferramentas do Marketplace

Ferramentas de persona de agente

Parâmetros de generate_skills

Fontes suportadas

Configuração

Planos

Licença

Parâmetros de `generate_skills`