Ir para o conteúdo
Promovaweb

Skills dos agentes no ClickUpfy

As skills do ClickUpfy são cinco instruções em Markdown, embutidas no binário, que o agente de código lê para trabalhar nas tarefas do ClickUp numa ordem definida. Instaladas no projeto pelo npx skills add, elas dizem ao agente quando ler a tarefa inteira, publicar o plano, iniciar o cronômetro, marcar um checklist e escolher o status final, por isso a mesma tarefa recebe o mesmo tratamento no Claude Code, no Codex e nos outros clientes.

Ficha e sumário da página

Referência técnica
ClickUpfy v1.1.2
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Instruções que acompanham o binário
  2. As cinco skills
  3. Instalação no projeto
  4. Antes de instalar, leia a skill
  5. Como o agente recebe a skill

Instruções que acompanham o binário

Uma skill é um arquivo SKILL.md com instruções para o agente de código: o que fazer, quando fazer e com quais comandos. As cinco skills do ClickUpfy vêm embutidas no binário e são mantidas em português do Brasil. Elas usam a CLI ou o servidor MCP disponível no projeto e não guardam API key nem ID de workspace, então o mesmo arquivo serve para qualquer perfil.

A skill e o MCP fazem trabalhos diferentes. O servidor MCP expõe as ferramentas e recusa chamadas fora do escopo do projeto. A skill descreve a sequência: qual ferramenta chamar primeiro, o que registrar como comentário, quando iniciar o tempo e o que conferir no fim. Sem a skill, o agente conhece as ferramentas, mas escolhe a ordem de novo a cada conversa. Com ela instalada, a sequência fica escrita no repositório e se repete em todas as conversas.

As cinco skills

Cada skill cobre um tipo de trabalho e limita o agente a ele. A skill de criação não implementa a tarefa que cria, assim como a skill diária não transforma uma consulta numa implementação completa.

  • clickupfy-setupConfere o ambiente com doctor, orienta o perfil, instala as skills e cria o MCP depois de confirmar os IDs.
  • clickupfy-devFaz consultas e alterações pontuais do dia a dia, como publicar o resultado de um teste numa tarefa.
  • clickup-issue-createTransforma uma solicitação em tarefa com subtarefas e checklists de teste, sem implementar.
  • clickup-issue-implementExecuta uma tarefa existente com plano, comentários, tempo, testes e status final.
  • clickupfy-releaseAcompanha versão, changelog, validações e artefatos de uma release do próprio repositório.
  • --skillDocumentação embutida do binário, que o agente lê sem acesso ao repositório do ClickUpfy.

A skill clickup-issue-implement concentra o caminho mais longo. Ela lê a tarefa inteira, monta um plano visível, registra o início e o tempo quando aplicável, percorre subtarefas e itens de checklist e publica checkpoints na tarefa. Um item de teste só fecha depois que o comando correspondente passa. A conclusão exige a releitura do estado remoto, a regressão do projeto e um status terminal que exista na List. A página Para que serve o ClickUpfy mostra esse ciclo com as ferramentas do servidor MCP.

A skill clickupfy-release lê a documentação de release do repositório onde ela está instalada. Por isso a documentação recomenda não instalá-la em projetos que só consomem a CLI.

Instalação no projeto

O ClickUpfy delega a instalação ao gerenciador de skills. O comando clickupfy agent skill install roda npx skills add promovaweb/clickupfy na raiz do repositório. O gerenciador grava as skills em .agents/skills/ e registra a origem e o hash de cada uma no skills-lock.json. Com a opção --global, a instalação vai para o catálogo do usuário, em ~/.codex/skills/. Informar nomes instala só as skills escolhidas.

  • raiz do projeto/Repositório ligado a uma List do ClickUp.
  • .agents/skills/Pasta das skills instaladas pelo gerenciador.
  • clickupfy-setup/Configuração de perfil, skills e MCP.
  • clickupfy-dev/Consultas e alterações pontuais.
  • clickup-issue-create/Criação de tarefa sem implementação.
  • clickup-issue-implement/Execução acompanhada até o status final.
  • clickupfy-release/Versões e artefatos do repositório.
  • skills-lock.jsonOrigem e hash de cada skill instalada.
  • .mcp.jsonServidor MCP do Claude Code com perfil e IDs.
  • .codex/config.tomlA mesma entrada no formato do Codex.
O que o comando agent install deixa na raiz do repositório: as cinco skills em .agents/skills/, o registro do gerenciador e o servidor MCP fixado nos arquivos do Claude Code e do Codex.

O comando clickupfy agent install junta as duas etapas: instala as skills e grava o servidor MCP fixado no .mcp.json e no .codex/config.toml, com Space e List obrigatórios. A documentação prefere a instalação local quando projetos diferentes usam versões ou instruções diferentes, porque as skills ficam versionadas junto com o código. O comando npx skills list mostra o que está instalado. A atualização passa pelo próprio npx skills add, que mantém o lockfile.

Antes de instalar, leia a skill

O comando clickupfy agent skill list mostra o catálogo com nome e descrição. O comando agent skill show imprime a fonte embutida de uma skill, para você revisar o fluxo e as permissões que ela usa. Como as skills são texto, a revisão acontece no terminal, sem baixar nada.

O binário também carrega a própria documentação. O comando clickupfy --skill imprime a documentação inteira em Markdown. Já clickupfy --skill mcp imprime só o tópico do servidor MCP. Um agente sem acesso ao repositório do ClickUpfy lê a referência pelo binário instalado, na mesma versão que ele executa.

Como o agente recebe a skill

A skill entra na conversa pelo nome. Na documentação, o exemplo de implementação chama $clickup-issue-implement com o ID da tarefa e a instrução de executar até a validação final. O exemplo de criação chama $clickup-issue-create com a instrução explícita de não implementar o trabalho. O escopo continua limitado pela instrução da conversa: a skill define a ordem do trabalho autorizado, sem ampliar o que você autorizou.

O percurso completo, com os comandos de instalação e os exemplos de cada skill, está em Skills dos agentes na documentação. O próximo assunto deste portal é o perfil local que as skills e o servidor MCP usam para falar com o ClickUp, na página Perfis, workspaces e cofre.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.