Claude Skills es el formato de paquete 2026 de Anthropic para capacidades de agentes reutilizables. Una habilidad reside en ~/.claude/skills y está disponible para cada sesión de Claude Code y Claude Desktop. Este tutorial explica cómo empaquetar Scavio como Claude Skill para que cualquier sesión de Claude pueda buscar en la web, YouTube, Amazon, Walmart y Reddit con un solo comando.
Requisitos previos
- Claude Code o Claude Desktop instalado
- Una clave API de Scavio
- Nodo.js 20+
Guia paso a paso
Paso 1: Crear el directorio de habilidades
Las habilidades se encuentran en ~/.claude/skills/<nombre>.
Bash
mkdir -p ~/.claude/skills/scavio
cd ~/.claude/skills/scavioPaso 2: Escribe el manifiesto de habilidades
Cada habilidad necesita un Skill.json que describa los comandos y parámetros.
JSON
{
"name": "scavio",
"version": "1.0.0",
"description": "Real-time search across Google, YouTube, Amazon, Walmart, and Reddit via Scavio",
"entrypoint": "index.js",
"commands": [
{ "name": "search", "description": "Search the web", "params": {"query": "string"} },
{ "name": "amazon", "description": "Search Amazon products", "params": {"query": "string"} },
{ "name": "youtube_transcript", "description": "Get a YouTube transcript", "params": {"video_id": "string"} }
]
}Paso 3: Escribe el controlador de habilidades
El punto de entrada recibe invocaciones de comando y llama a Scavio.
JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
export async function search({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}
export async function amazon({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ platform: 'amazon', query, marketplace: 'US' })
});
return r.json();
}Paso 4: Establecer la variable de entorno
Agregue SCAVIO_API_KEY a su perfil de shell para que cada sesión de Claude lo herede.
Bash
echo 'export SCAVIO_API_KEY=sk_live_...' >> ~/.zshrcPaso 5: Usa la habilidad en Claude Code
Inicie Claude Code e invoque la habilidad.
Bash
# In Claude Code
> /skills scavio search "best AI framework 2026"Ejemplo en Python
Python
# Skills are JS-native, but you can call Scavio from Python to validate:
import os, requests
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': os.environ['SCAVIO_API_KEY']},
json={'query': 'best AI framework 2026'})
print(r.json()['organic_results'][:3])Ejemplo en JavaScript
JavaScript
// scavio skill handler
const API_KEY = process.env.SCAVIO_API_KEY;
export async function search({ query }) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query })
});
return r.json();
}Salida esperada
JSON
Running /skills scavio search in Claude Code returns structured Google results inline. Every Claude Code and Claude Desktop session now has one-command search without per-project setup.