Referencia de herramientas de Skillry MCP

Llama a estas herramientas desde un cliente MCP conectado. Tu agente suele proporcionar los argumentos; esta referencia sirve para revisar llamadas y desarrollar integraciones.

skillry-cli@lateststdioskills:read

Comprobado: 26 oct 2026

Conecta tu cliente

Antes de llamar a una herramienta

Añádelo a tu cliente

Skillry usa un servidor stdio local en macOS o Windows con Node.js 22+. Las credenciales se guardan en el almacén seguro del sistema. /mcp es una página de configuración, no un endpoint MCP remoto.

Cuenta y autorización

Las llamadas de cuenta usan autorización en el navegador con skills:read. La credencial actual caduca a los 7 días y no se renueva automáticamente. CLI y MCP del mismo equipo comparten la credencial para la misma URL de servicio; desconectar la revoca.

Revisa requisitos y acceso antes de instalar. Conserva el Skill y la versión elegidos. Instalar no ejecuta el Skill, compra acceso ni paga a proveedores externos.

Sustituye <skill-slug> por un slug de search_skills y <published-version> por la versión publicada elegida. Usa rutas absolutas de tu equipo.

Descubrimiento

search_skills

Público

Busca Skills publicados por resultado deseado y requisitos explícitos. Usa palabras clave por defecto; una coincidencia no garantiza que puedas ejecutarlo en tu entorno.

Parámetros9

querystringOpcional

Resultado deseado o nombre/slug exacto. Describe la salida; un PDF o URL de entrada no define el tipo de resultado.

maxLength: 200 · Predeterminado ""

outputTypestringOpcional

Filtra por salida deseada. presentation es el valor de API para presentaciones.

deliveryScopestringOpcional

Selecciona una obra completa o un componente. Si falta información de alcance, requiere revisión.

complete | component

avoidVoiceoverbooleanOpcional

Usa true para excluir requisitos declarados de narración en el flujo principal.

allowApiKeysbooleanOpcional

Usa false para excluir claves de proveedor declaradas como obligatorias. Lo no declarado sigue siendo desconocido.

allowExternalCostsbooleanOpcional

Usa false para excluir costes externos declarados. Los costes desconocidos requieren revisión.

limitintegerOpcional

Máximo de resultados por llamada, según el rango y predeterminado de esta herramienta.

≥ 1 · ≤ 20 · Predeterminado 5

offsetintegerOpcional

Desplazamiento de paginación. Continúa con el nextOffset devuelto.

≥ 0 · ≤ 10000 · Predeterminado 0

localestringOpcional

Idioma del contenido. Usa valores exactos de API, incluidos zh-CN, zh-TW y pt-BR.

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · Predeterminado "en"

Ejemplo de argumentos · JSON

{
  "query": "product presentation",
  "outputType": "presentation",
  "avoidVoiceover": true,
  "allowApiKeys": false,
  "allowExternalCosts": false,
  "limit": 3
}

Resultado y comportamiento

Devuelve skills, nextOffset y estados de búsqueda/revisión. Revisa appliedRequirements, requirementReview, costNotice y clarificationQuestion. Lo desconocido requiere revisión; constraintsStatus: unconfirmed indica que el servicio no confirmó los filtros. Las puntuaciones no son probabilidades.

get_skill

Público

Consulta versión, vista previa, entradas, dependencias y costes externos de un Skill publicado antes de elegir.

Parámetros1

slugstringObligatorio

Slug exacto del Skill publicado que eligió el usuario: kebab-case en minúsculas, hasta 64 caracteres.

minLength: 1 · maxLength: 64

Ejemplo de argumentos · JSON

{
  "slug": "<skill-slug>"
}

Resultado y comportamiento

Devuelve metadatos públicos de la versión, sin conceder acceso ni incluir contenido privado del paquete.

Cuenta y autorización

connect_account

Autorización en el navegador

Inicia la autorización cuando el usuario pide conectar. Reutiliza cualquier flujo pendiente.

ParámetrosSin argumentos. Envía un objeto vacío.

Resultado y comportamiento

Devuelve verificationUrl, userCode, expiresAt, browserOpened y pollAfterSeconds. Muestra la URL y el código coincidente al usuario; nunca devuelve credenciales.

connection_status

Autorización en el navegador

Continúa una autorización pendiente. Vuelve a llamar tras el intervalo pollAfterSeconds indicado.

ParámetrosSin argumentos. Envía un objeto vacío.

Resultado y comportamiento

Informa de not_started, pending, denied, expired o connected. Tras aprobar, guarda el token en el almacén del sistema. Respeta el intervalo de consulta.

account_status

Requiere cuenta

Consulta membresía, caducidad, ámbito y cuota diaria de descargas actuales.

ParámetrosSin argumentos. Envía un objeto vacío.

Resultado y comportamiento

Devuelve connected, entitlement, scope, sessionExpiresAt, quota y pricingUrl, sin identidad personal ni credenciales.

disconnect_account

Requiere cuenta

Cancela la autorización pendiente, revoca la credencial compartida CLI/MCP y la elimina del almacén del sistema.

ParámetrosSin argumentos. Envía un objeto vacío.

Resultado y comportamiento

Revisa serverRevoked. Si falla la revocación remota, elimina la credencial local, pero el token del servidor podría seguir válido hasta caducar.

get_skill_access

Requiere cuenta

Comprueba el acceso a un Skill publicado antes de descargar. No reserva ni consume cuota.

Parámetros1

slugstringObligatorio

Slug exacto del Skill publicado que eligió el usuario: kebab-case en minúsculas, hasta 64 caracteres.

minLength: 1 · maxLength: 64

Ejemplo de argumentos · JSON

{
  "slug": "<skill-slug>"
}

Resultado y comportamiento

Devuelve access (free, purchased, member o purchase_required), canDownload, reason, purchaseUrl, version y quota. La descarga vuelve a comprobar los permisos.

Descargas, instalación y actualizaciones

download_skill

Requiere cuentaModifica archivos locales

Guarda un ZIP verificado en un directorio absoluto elegido. Nunca sobrescribe archivos existentes.

Parámetros3

slugstringObligatorio

Slug exacto del Skill publicado que eligió el usuario: kebab-case en minúsculas, hasta 64 caracteres.

minLength: 1 · maxLength: 64

downloadDirectorystringObligatorio

Directorio absoluto explícito para el ZIP. No usa agente ni ámbito de instalación.

maxLength: 4096

expectedVersionstringOpcional

Versión publicada elegida. Obligatoria al actualizar; opcional al instalar/descargar. Revisa de nuevo si cambia la versión publicada.

minLength: 1 · maxLength: 64

Ejemplo de argumentos · JSON

{
  "slug": "<skill-slug>",
  "downloadDirectory": "/absolute/path/downloads",
  "expectedVersion": "<published-version>"
}

Resultado y comportamiento

Tras verificar ZIP y versión, devuelve archivePath, slug, version y sha256. No instala ni informa de instalación completada.

install_skill

Requiere cuentaModifica archivos locales

Instala la versión elegida para un agente y ámbito explícitos. No sobrescribe directorios de Skills existentes.

Parámetros5

slugstringObligatorio

Slug exacto del Skill publicado que eligió el usuario: kebab-case en minúsculas, hasta 64 caracteres.

minLength: 1 · maxLength: 64

agentstringObligatorio

Destino de instalación, distinto del cliente MCP. global usa el directorio configurado; project solo admite shared o claude-code.

scopestringOpcional

global instala para tu usuario del sistema; project, dentro de projectDirectory explícito.

global | project · Predeterminado "global"

projectDirectorystringOpcional

Ruta absoluta del proyecto, obligatoria con scope: project y no permitida con scope: global. shared usa .agents/skills; claude-code, .claude/skills.

maxLength: 4096

expectedVersionstringOpcional

Versión publicada elegida. Obligatoria al actualizar; opcional al instalar/descargar. Revisa de nuevo si cambia la versión publicada.

minLength: 1 · maxLength: 64

Ejemplo de argumentos · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

Resultado y comportamiento

Devuelve targetPath, skillFile, version, completionReported e inventoryRecorded. Lee SKILL.md y revisa costes antes de ejecutar.

list_installed_skills

Archivos locales

Lee los Skills del directorio local elegido. Solo las instalaciones gestionadas por Skillry tienen una versión registrada.

Parámetros3

agentstringObligatorio

Destino de instalación, distinto del cliente MCP. global usa el directorio configurado; project solo admite shared o claude-code.

scopestringOpcional

global instala para tu usuario del sistema; project, dentro de projectDirectory explícito.

global | project · Predeterminado "global"

projectDirectorystringOpcional

Ruta absoluta del proyecto, obligatoria con scope: project y no permitida con scope: global. shared usa .agents/skills; claude-code, .claude/skills.

maxLength: 4096

Ejemplo de argumentos · JSON

{
  "agent": "shared",
  "scope": "global"
}

Resultado y comportamiento

Devuelve entradas locales y su estado managed/version. La versión de los Skills no gestionados es desconocida y no se actualizan sin revisión.

check_updates

Archivos locales

Compara instalaciones gestionadas con versiones publicadas. La consulta no descarga ni instala actualizaciones.

Parámetros5

agentstringObligatorio

Destino de instalación, distinto del cliente MCP. global usa el directorio configurado; project solo admite shared o claude-code.

scopestringOpcional

global instala para tu usuario del sistema; project, dentro de projectDirectory explícito.

global | project · Predeterminado "global"

projectDirectorystringOpcional

Ruta absoluta del proyecto, obligatoria con scope: project y no permitida con scope: global. shared usa .agents/skills; claude-code, .claude/skills.

maxLength: 4096

offsetintegerOpcional

Desplazamiento de paginación. Continúa con el nextOffset devuelto.

≥ 0 · ≤ 9007199254740991 · Predeterminado 0

limitintegerOpcional

Máximo de resultados por llamada, según el rango y predeterminado de esta herramienta.

≥ 1 · ≤ 5 · Predeterminado 5

Ejemplo de argumentos · JSON

{
  "agent": "shared",
  "scope": "global",
  "offset": 0,
  "limit": 5
}

Resultado y comportamiento

Devuelve current, update_available, unavailable o unmanaged por entrada, y nextOffset. Continúa con el mismo agente y ámbito.

update_skill

Requiere cuentaModifica archivos locales

Actualiza una Skill gestionada por Skillry e instalada en tu ordenador a la versión aprobada expresamente por el usuario. Conserva una copia de todo el directorio anterior, incluidas las modificaciones locales.

Parámetros5

agentstringObligatorio

Destino de instalación, distinto del cliente MCP. global usa el directorio configurado; project solo admite shared o claude-code.

scopestringOpcional

global instala para tu usuario del sistema; project, dentro de projectDirectory explícito.

global | project · Predeterminado "global"

projectDirectorystringOpcional

Ruta absoluta del proyecto, obligatoria con scope: project y no permitida con scope: global. shared usa .agents/skills; claude-code, .claude/skills.

maxLength: 4096

slugstringObligatorio

Slug exacto del Skill publicado que eligió el usuario: kebab-case en minúsculas, hasta 64 caracteres.

minLength: 1 · maxLength: 64

expectedVersionstringObligatorio

Versión publicada elegida. Obligatoria al actualizar; opcional al instalar/descargar. Revisa de nuevo si cambia la versión publicada.

minLength: 1 · maxLength: 64

Ejemplo de argumentos · JSON

{
  "slug": "<skill-slug>",
  "agent": "shared",
  "scope": "global",
  "expectedVersion": "<published-version>"
}

Resultado y comportamiento

Al sustituir, devuelve la versión instalada y backupPath. Si ya tiene la versión indicada, no sustituye nada.

Directorios de instalación

En global, shared, codex, cursor, gemini-cli, opencode y kimi-code usan ~/.agents/skills; claude-code usa ~/.claude/skills; antigravity usa ~/.gemini/config/skills. project usa <projectDirectory>/.agents/skills o <projectDirectory>/.claude/skills. No deduzcas el proyecto del directorio de trabajo del proceso MCP.

Ejemplo de argumentos · install_skill

{
  "slug": "<skill-slug>",
  "agent": "claude-code",
  "scope": "project",
  "projectDirectory": "/absolute/path/project",
  "expectedVersion": "<published-version>"
}

Estados y soluciones

Falta autorización o ha caducado: Ante authentication_required o session_expired, pide conectar, llama a connect_account, muestra URL/código y consulta connection_status al intervalo indicado. Reintenta la operación tras aprobar.
El directorio del Skill ya existe: Ante skill_already_installed, revisa el mismo destino con list_installed_skills y check_updates. Pide aprobación antes de actualizar una instalación gestionada a la nueva versión elegida. MCP no tiene argumento force.
Se requiere compra o se agotó la cuota diaria: Para purchase_required o premium_required, usa purchaseUrl/actionUrl. Para daily_download_limit, muestra resetsAt. Repetir la descarga del mismo Skill ese día no consume otra plaza de Skill distinto; la cuota se reinicia a las 00:00 UTC.
No aparecen herramientas de Skillry: Comprueba Node.js 22+, la configuración del sistema y los registros del cliente. Reinicia o recarga tras añadir el servidor. El entorno solo navegador y Linux quedan fuera de la configuración compatible actual.

Más información

Conecta tu cliente Conectar Skillry MCP Model Context Protocol