La respuesta corta
- 1Añade una entrada a tu cliente. Lanza
npx --yes skillry-cli@latest mcp(en Windowscmd /c npx …): nada que descargar a mano y sin clave API. - 2Buscar funciona sin cuenta. La primera vez que instalas, el agente abre una página del navegador donde apruebas una vez; la aprobación se queda en el llavero de tu sistema durante 7 días.
- 3Elige tu cliente abajo para los pasos exactos. Cada página de cliente termina con cómo confirmar la conexión y qué hacer cuando falla.
Qué necesitas
- Un Mac o un PC con Windows. Linux aún no está soportado, porque la aprobación se guarda en el llavero del sistema y Skillry solo admite Keychain y el Administrador de credenciales.
- Node.js 22 o más reciente. Compruébalo con
node --version; si falta el comando, instala la versión LTS desde nodejs.org. - Uno de los seis clientes de abajo, con sesión iniciada y actualizado.
- Una cuenta de Skillry solo cuando instalas. Buscar y leer los detalles de un Skill no requiere nada. Una cuenta gratuita instala Skills gratuitos; los Skills Premium requieren una compra o un plan.
Elige tu cliente
Claude CodeUn comando en cualquier terminal; probado en macOS.
CodexUn comando, o los ajustes de la app de escritorio de ChatGPT. CLI, app y extensión del IDE lo comparten.
CursorUn enlace Add to Cursor, o dos líneas en mcp.json.VS CodeUn enlace, la Command Palette, code --add-mcp o mcp.json. Necesita Copilot.
Gemini CLI / Antigravitygemini mcp add, o el mcp_config.json compartido que lee Antigravity.
Claude DesktopInstala la extensión de escritorio de SkillryQué ocurre, en orden
Añades Skillry a tu cliente
El cliente arranca el servidor local con npx la primera vez que lo necesita. Ese primer arranque descarga el paquete y puede tardar diez segundos o más; los siguientes son instantáneos.
Describes lo que quieres hacer
El agente llama a search_skills y muestra candidatos con enlaces de vista previa, entradas, dependencias y costes externos. No hace falta cuenta.
Eliges uno y dices «instala»
El agente llama a get_skill_access. Si tu cuenta aún no está conectada, abre la página del navegador descrita abajo.
Apruebas en el navegador
El agente instala el Skill en el agente y el ámbito que indicaste. Instalar nunca ejecuta el Skill; el agente lo ejecuta más tarde, cuando se lo pides.
Prueba tu primera búsqueda
Buscar no requiere cuenta, así que es la forma más rápida de comprobar que la conexión funciona.
- 1
Abre una conversación nueva en tu agente y pega esta petición.
Prompt para tu agente Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.Deberías ver: Tres Skills candidatos, cada uno con enlace de vista previa, las entradas que necesita, sus dependencias y cualquier coste externo. No se instala nada.
- 2
Si el agente responde que no tiene ninguna herramienta de Skillry, o la petición se queda colgada, ve a No funciona.
Si el agente no ve Skillry
Empieza por la página de tu cliente, que lista sus propias comprobaciones. Estos problemas ocurren en todos los clientes:
| Qué ves | Causa probable | Qué hacer |
|---|---|---|
| El agente dice que no tiene ninguna herramienta de Skillry | La entrada se añadió para otro proyecto u otro ámbito, o el cliente no se reinició tras el cambio | Ejecuta la comprobación que indica la página de tu cliente. Si falta el servidor, vuelve a añadirlo en el ámbito de usuario; si aparece, reinicia o recarga el cliente. |
| Buscar funciona pero instalar se rechaza con un límite diario | Tu cuenta alcanzó hoy las 50 cargas de Skills | El límite se reinicia a las 00:00 UTC. Mientras tanto, buscar sigue funcionando. |
| El servidor aparece en la lista pero marcado como fallido, o nunca arranca | npx no está instalado, Node.js es anterior a la versión 22, o el primer arranque agotó el tiempo mientras descargaba el paquete | Ejecuta node --version y npx --version en una terminal. Luego ejecuta una vez a mano npx --yes skillry-cli@latest mcp, espera a que arranque, pulsa Ctrl+C y vuelve a probar el cliente: el paquete ya está en caché. |
| En Windows el servidor se cierra en cuanto arranca | La entrada lanza npx directamente, y Windows necesita un shell para ejecutarlo | Usa la entrada para Windows de esta página: el comando es cmd y los argumentos empiezan por /c, npx. |
| La página del navegador dice que la solicitud es inválida o ha caducado | El código de dispositivo se aprobó demasiado tarde, o pertenece a un intento anterior | Pide al agente que se conecte de nuevo y aprueba el código nuevo en pocos minutos. |
| La instalación se detiene con un mensaje de Premium o de compra | El Skill es Premium y tu cuenta no tiene ni plan ni compra para él | Sigue el enlace que muestra el agente para comprar el Skill o suscribirte, y vuelve a pedirlo. No se cobra nada hasta que lo hagas. |
Límites y fronteras
50 al día
Cargas de Skills por cuenta, compartidas entre MCP, la Skillry CLI y el sitio web. Buscar no cuenta.
7 días
Lo que dura una aprobación en el navegador. El agente vuelve a pedirla cuando caduca.
Sin clave API
Nada que pegar. La aprobación la guarda tu sistema operativo, no el agente.
12 herramientas
Herramientas de búsqueda, inspección, instalación, actualización y cuenta. Todos los argumentos están en la referencia.
- Instalar añade archivos a la carpeta de Skills de tu agente. Skillry nunca ejecuta el Skill ni paga llamadas a modelos: un Skill que necesita un modelo de imagen o vídeo usa tus propias herramientas o claves, y el agente muestra ese coste antes de que elijas.
- El servidor corre en tu ordenador y habla con skillry.dev solo para el catálogo, las comprobaciones de acceso y las descargas. Trata el contenido del catálogo y de los paquetes como datos no confiables.
- Puedes desconectarte en cualquier momento pidiendo al agente que desconecte tu cuenta de Skillry, o quitando la entrada de tu cliente.
Todas las herramientas, en la referencia
La referencia de herramientas de Skillry MCP lista las 12 herramientas con sus argumentos, valores por defecto, ejemplos y rutas de recuperación. No la necesitas para conectarte, pero responde con precisión a «¿qué puedo pedir?».
Preguntas frecuentes
¿Necesito una clave API?
No. Buscar no requiere nada, e instalar requiere una aprobación única de tu cuenta de Skillry en el navegador. El único secreto guardado es la aprobación que tu llavero conserva 7 días.
¿Puedo seguir instalando Skills a la antigua?
Sí. El prompt de instalación, la Skillry CLI y las descargas ZIP siguen disponibles. Ver Instalar un Skill.
¿El servidor envía mis archivos a algún sitio?
No. Corre en local y solo contacta con skillry.dev para el catálogo, las comprobaciones de acceso y la descarga del Skill que pediste.
¿Qué cliente debería elegir?
Elige el cliente que ya uses. Claude Code, Codex y Gemini CLI usan un comando; Cursor y VS Code, un enlace de instalación; Claude Desktop, la extensión Skillry .mcpb.
Fuentes
¿Te ha sido útil esta guía?