Referência de ferramentas do Skillry MCP

Chame estas ferramentas em um cliente MCP conectado. O agente normalmente fornece os argumentos; esta referência ajuda a revisar chamadas e desenvolver integrações.

skillry-cli@lateststdioskills:read

Conferido: 26 out 2026

Conecte seu cliente

Antes de chamar uma ferramenta

Adicione ao seu cliente

O Skillry usa um servidor stdio local no macOS ou Windows com Node.js 22+. As credenciais ficam no armazenamento seguro do sistema. /mcp é uma página de configuração, não um endpoint MCP remoto.

Conta e autorização

As chamadas de conta usam autorização no navegador com skills:read. A credencial atual expira após 7 dias, sem renovação automática. CLI e MCP no mesmo computador compartilham a credencial da mesma URL de serviço; desconectar a revoga.

Confira requisitos e acesso antes de instalar. Preserve o Skill e a versão escolhidos. Instalar não executa o Skill, compra acesso nem paga provedores externos.

Substitua <skill-slug> por um slug retornado por search_skills e <published-version> pela versão publicada escolhida. Use caminhos absolutos do seu computador.

Descoberta

search_skills

Público

Busca Skills publicados pelo resultado desejado e requisitos explícitos. O padrão é busca por palavras-chave; corresponder não garante execução no seu ambiente.

Parâmetros9

querystringOpcional

Resultado desejado ou nome/slug exato. Descreva a saída; um PDF ou URL de entrada não define o tipo de resultado.

maxLength: 200 · Padrão ""

outputTypestringOpcional

Filtra pelo tipo de saída desejado. presentation é o valor da API para apresentações.

deliveryScopestringOpcional

Selecione uma obra completa ou um componente. Se faltar informação de escopo, será necessária revisão.

complete | component

avoidVoiceoverbooleanOpcional

Defina true para excluir requisitos declarados de narração no fluxo principal.

allowApiKeysbooleanOpcional

Defina false para excluir chaves de provedor declaradas como obrigatórias. O que não foi declarado continua desconhecido.

allowExternalCostsbooleanOpcional

Defina false para excluir custos externos declarados. Custos desconhecidos ainda exigem revisão.

limitintegerOpcional

Máximo de resultados por chamada. Use o intervalo e padrão indicados nesta ferramenta.

≥ 1 · ≤ 20 · Padrão 5

offsetintegerOpcional

Deslocamento de paginação. Continue com o nextOffset retornado.

≥ 0 · ≤ 10000 · Padrão 0

localestringOpcional

Idioma do conteúdo. Use os valores exatos da API, incluindo zh-CN, zh-TW e pt-BR.

en | zh-CN | zh-TW | ja | ko | es | pt-BR | de | fr · Padrão "en"

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna skills, nextOffset e estados de busca/revisão. Confira appliedRequirements, requirementReview, costNotice e clarificationQuestion. Requisitos desconhecidos precisam de revisão; constraintsStatus: unconfirmed indica que o serviço não confirmou os filtros. Pontuações não são probabilidades.

get_skill

Público

Consulta versão, prévia, entradas, dependências e custos externos de um Skill publicado antes da escolha.

Parâmetros1

slugstringObrigatório

Slug exato do Skill publicado escolhido: kebab-case em minúsculas, até 64 caracteres.

minLength: 1 · maxLength: 64

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna metadados públicos da versão, sem conceder acesso nem incluir conteúdo privado do pacote.

Conta e autorização

connect_account

Autorização no navegador

Inicia a autorização no navegador quando o usuário pede para conectar. Reutiliza um fluxo pendente.

ParâmetrosSem argumentos. Envie um objeto vazio.

Resultado e comportamento

Retorna verificationUrl, userCode, expiresAt, browserOpened e pollAfterSeconds. Mostre URL e código correspondente ao usuário; credenciais nunca são retornadas.

connection_status

Autorização no navegador

Continua uma autorização pendente. Chame novamente após o intervalo pollAfterSeconds retornado.

ParâmetrosSem argumentos. Envie um objeto vazio.

Resultado e comportamento

Informa not_started, pending, denied, expired ou connected. Após aprovação, salva o token no armazenamento seguro do sistema. Respeite o intervalo de consulta.

account_status

Exige conta

Consulta assinatura, validade da autorização, escopo e cota diária de downloads atuais.

ParâmetrosSem argumentos. Envie um objeto vazio.

Resultado e comportamento

Retorna connected, entitlement, scope, sessionExpiresAt, quota e pricingUrl, sem identidade pessoal nem credenciais.

disconnect_account

Exige conta

Cancela a autorização pendente, revoga a credencial compartilhada CLI/MCP e a remove do armazenamento seguro do sistema.

ParâmetrosSem argumentos. Envie um objeto vazio.

Resultado e comportamento

Confira serverRevoked. Se a revogação remota falhar, a credencial local é removida, mas o token do servidor pode continuar válido até expirar.

get_skill_access

Exige conta

Confere o acesso a um Skill publicado antes do download. Não reserva nem consome cota.

Parâmetros1

slugstringObrigatório

Slug exato do Skill publicado escolhido: kebab-case em minúsculas, até 64 caracteres.

minLength: 1 · maxLength: 64

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna access (free, purchased, member ou purchase_required), canDownload, reason, purchaseUrl, version e quota. O download verifica as permissões novamente.

Downloads, instalação e atualizações

download_skill

Exige contaAltera arquivos locais

Salva um ZIP verificado em um diretório absoluto escolhido. Nunca sobrescreve arquivos existentes.

Parâmetros3

slugstringObrigatório

Slug exato do Skill publicado escolhido: kebab-case em minúsculas, até 64 caracteres.

minLength: 1 · maxLength: 64

downloadDirectorystringObrigatório

Diretório absoluto explícito para salvar o ZIP. Não usa agente nem escopo de instalação.

maxLength: 4096

expectedVersionstringOpcional

Versão publicada selecionada. Obrigatória para atualizar; opcional para instalar/baixar. Revise novamente se a versão publicada mudar.

minLength: 1 · maxLength: 64

Exemplo de argumentos · JSON

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

Resultado e comportamento

Após validar ZIP e versão, retorna archivePath, slug, version e sha256. Não instala nem registra conclusão de instalação.

install_skill

Exige contaAltera arquivos locais

Instala a versão selecionada para um agente e escopo explícitos. Não sobrescreve diretórios de Skills existentes.

Parâmetros5

slugstringObrigatório

Slug exato do Skill publicado escolhido: kebab-case em minúsculas, até 64 caracteres.

minLength: 1 · maxLength: 64

agentstringObrigatório

Destino de instalação, diferente do cliente MCP. global usa o diretório configurado; project aceita apenas shared ou claude-code.

scopestringOpcional

global instala para seu usuário do sistema; project instala em projectDirectory explícito.

global | project · Padrão "global"

projectDirectorystringOpcional

Caminho absoluto do projeto, obrigatório em scope: project e não permitido em scope: global. shared usa .agents/skills; claude-code usa .claude/skills.

maxLength: 4096

expectedVersionstringOpcional

Versão publicada selecionada. Obrigatória para atualizar; opcional para instalar/baixar. Revise novamente se a versão publicada mudar.

minLength: 1 · maxLength: 64

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna targetPath, skillFile, version, completionReported e inventoryRecorded. Leia SKILL.md e confira os custos antes de executar.

list_installed_skills

Arquivos locais

Lê os Skills no diretório local escolhido. Só instalações gerenciadas pelo Skillry têm uma versão publicada registrada.

Parâmetros3

agentstringObrigatório

Destino de instalação, diferente do cliente MCP. global usa o diretório configurado; project aceita apenas shared ou claude-code.

scopestringOpcional

global instala para seu usuário do sistema; project instala em projectDirectory explícito.

global | project · Padrão "global"

projectDirectorystringOpcional

Caminho absoluto do projeto, obrigatório em scope: project e não permitido em scope: global. shared usa .agents/skills; claude-code usa .claude/skills.

maxLength: 4096

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna itens locais e seu estado managed/version. Skills não gerenciados têm versão desconhecida e não podem ser atualizados sem revisão.

check_updates

Arquivos locais

Compara instalações gerenciadas com versões publicadas. Verificar não baixa nem instala atualizações.

Parâmetros5

agentstringObrigatório

Destino de instalação, diferente do cliente MCP. global usa o diretório configurado; project aceita apenas shared ou claude-code.

scopestringOpcional

global instala para seu usuário do sistema; project instala em projectDirectory explícito.

global | project · Padrão "global"

projectDirectorystringOpcional

Caminho absoluto do projeto, obrigatório em scope: project e não permitido em scope: global. shared usa .agents/skills; claude-code usa .claude/skills.

maxLength: 4096

offsetintegerOpcional

Deslocamento de paginação. Continue com o nextOffset retornado.

≥ 0 · ≤ 9007199254740991 · Padrão 0

limitintegerOpcional

Máximo de resultados por chamada. Use o intervalo e padrão indicados nesta ferramenta.

≥ 1 · ≤ 5 · Padrão 5

Exemplo de argumentos · JSON

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

Resultado e comportamento

Retorna current, update_available, unavailable ou unmanaged para cada item, além de nextOffset. Continue com o mesmo agente e escopo.

update_skill

Exige contaAltera arquivos locais

Atualiza uma Skill gerenciada pela Skillry e instalada no seu computador para a versão aprovada explicitamente pelo usuário. Faz backup de todo o diretório anterior, incluindo alterações locais.

Parâmetros5

agentstringObrigatório

Destino de instalação, diferente do cliente MCP. global usa o diretório configurado; project aceita apenas shared ou claude-code.

scopestringOpcional

global instala para seu usuário do sistema; project instala em projectDirectory explícito.

global | project · Padrão "global"

projectDirectorystringOpcional

Caminho absoluto do projeto, obrigatório em scope: project e não permitido em scope: global. shared usa .agents/skills; claude-code usa .claude/skills.

maxLength: 4096

slugstringObrigatório

Slug exato do Skill publicado escolhido: kebab-case em minúsculas, até 64 caracteres.

minLength: 1 · maxLength: 64

expectedVersionstringObrigatório

Versão publicada selecionada. Obrigatória para atualizar; opcional para instalar/baixar. Revise novamente se a versão publicada mudar.

minLength: 1 · maxLength: 64

Exemplo de argumentos · JSON

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

Resultado e comportamento

Quando há substituição, retorna a versão instalada e backupPath. Se a versão já for a indicada, não substitui nada.

Diretórios de instalação

Em global, shared, codex, cursor, gemini-cli, opencode e kimi-code usam ~/.agents/skills; claude-code usa ~/.claude/skills; antigravity usa ~/.gemini/config/skills. project usa <projectDirectory>/.agents/skills ou <projectDirectory>/.claude/skills. Não deduza o projeto pelo diretório de trabalho do processo MCP.

Exemplo de argumentos · install_skill

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

Estados e soluções

Conta sem autorização ou autorização expirada: Para authentication_required ou session_expired, peça para conectar, chame connect_account, mostre URL/código e consulte connection_status no intervalo indicado. Tente a operação original após a aprovação.
O diretório do Skill já existe: Para skill_already_installed, confira o mesmo destino com list_installed_skills e check_updates. Peça aprovação antes de atualizar uma instalação gerenciada para a nova versão selecionada. MCP não tem argumento force.
Compra necessária ou cota diária esgotada: Para purchase_required ou premium_required, siga purchaseUrl/actionUrl. Para daily_download_limit, mostre resetsAt. Repetir o download do mesmo Skill no dia não consome outra vaga de Skill diferente; a cota reinicia às 00:00 UTC.
As ferramentas do Skillry não aparecem: Confira Node.js 22+, a configuração do sistema e os logs do cliente. Reinicie ou recarregue após adicionar o servidor. Ambientes apenas de navegador e Linux não são compatíveis com a configuração atual.

Saiba mais

Conecte seu cliente Conectar a Skillry MCP Model Context Protocol