Skip to content

Dailybot Agent Skill

O Dailybot Agent Skill é um único skill pack cross-agent que se instala em cada CLI de programação de IA relevante com um único comando. Uma vez instalado, seu agente tem os mesmos verbos que um teammate humano — reportar progresso, completar check-ins, enviar um email, dar kudos a um colega, postar no Slack ou Teams, enviar um formulário, ou anunciar sua própria saúde. Cada sub-skill mapeia 1:1 para um endpoint público da API do Dailybot. Esta página é a referência técnica; para o pitch em linguagem simples leia /skills/agent-skill.

Dois comandos e seu agente é um teammate

Instale a CLI base e depois adicione a skill ao .agents/skills/do seu projeto. Todo o resto nesta página é material de referência sobre o que acontece depois desses dois comandos.

Instalação

Pré-requisitos: dailybot-cli >= 1.10.0 como base —>= 1.17.2 é obrigatória para a superfície de authoring (criar/configurar check-ins e forms, report channels). O router doagent-skill instala a CLI no primeiro uso a partir dehttps://cli.dailybot.com/install.sh, verificada com SHA-256. O skill pack está fixado emDailybotHQ/agent-skill >= 1.8.3.

Recomendado — qualquer CLI de IA

Instale a CLI base e depois adicione a skill ao seu projeto:

bash
curl -fsSL https://cli.dailybot.com/install.sh | bash
npx skills add DailybotHQ/agent-skill

Claude Code · Cursor · OpenAI Codex CLI · Gemini CLI

Agentes baseados em npm leem .agents/skills/ diretamente. Um único comando basta:

bash
npx skills add DailybotHQ/agent-skill

GitHub Copilot · Cline · Windsurf

Qualquer harness que leia .agents/skills/ funciona. Clone a skill no lugar:

bash
git clone https://github.com/DailybotHQ/agent-skill \
  .agents/skills/dailybot-agent

Manual

bash
git clone https://github.com/DailybotHQ/agent-skill
cd agent-skill && ./setup.sh

Info

Defina DAILYBOT_AUTO_YES=1 em CI para pular o prompt de consentimento do primeiro install, para que rodadas não atendidas nunca fiquem travadas.

Layout de arquivos

Uma vez instalada, a skill vive dentro de.agents/skills/dailybot-agent/ do seu projeto. A política e identidade por repo vivem em .dailybot/. Cada arquivo é texto puro — sem binários, sem módulos Node empacotados. Instalar é copiar; desinstalar érm -rf .agents/skills/dailybot-agent/.

text
<repo>/
├── .agents/
│   ├── skills/
│   │   └── dailybot-agent/
│   │       ├── SKILL.md          # top-level router
│   │       ├── report/SKILL.md
│   │       ├── checkin/SKILL.md
│   │       ├── chat/SKILL.md
│   │       ├── kudos/SKILL.md
│   │       ├── forms/SKILL.md
│   │       ├── teams/SKILL.md
│   │       ├── health/SKILL.md
│   │       ├── email/SKILL.md
│   │       ├── conversation/SKILL.md
│   │       ├── ask/SKILL.md
│   │       ├── messages/SKILL.md
│   │       ├── workflow/SKILL.md
│   │       └── channels/SKILL.md
│   └── settings.json             # optional harness hooks (Claude Code)
├── .cursor → .agents             # symlink (Cursor reads hooks.json here)
├── .claude → .agents             # symlink for legacy Claude Code paths
└── .dailybot/
    ├── profile.json              # per-repo identity + policy (commit)
    └── disabled                  # opt-out flag (commit or keep local)

Autenticação

A skill é um wrapper fino sobre a CLI dailybot. O auth é herdado da primeira credencial que a CLI resolve — ambas têm escopos idênticos (a paridade é uma garantia escrita, sem surpresas de escopo reduzido em CI).

OrigemSetupCaso de uso
dailybot loginOTP por email interativoMáquinas de developer, rodadas ad-hoc
DAILYBOT_API_KEYVariável de ambienteCI, agentes não atendidos, runners headless

Precedência: DAILYBOT_API_KEY vence quando ambas estão definidas. Verifique a credencial resolvida com:

bash
dailybot status --auth

Detalhes completos: Autenticação.

Referência de sub-skills

O pack expõe treze sub-skills, uma por cada verbo público do Dailybot. Cada uma é um wrapper fino sobre o comando dailybotcorrespondente — tudo o que a skill faz você pode fazer direto com a CLI também.

Sub-skillComando CLIAuthPropósito
reportdailybot agent updatede agentePostar um update tipo standup de 1–3 frases
checkindailybot checkin …de usuárioListar / completar check-ins pendentes; authoring
chatdailybot chat send / updateusuário ou org keyEnviar + editar mensagens bot no Slack/Teams/Discord/Google Chat
kudosdailybot kudos givede usuárioReconhecer um teammate ou um time inteiro
formsdailybot form …de usuárioCiclo completo de respostas + authoring de forms
teamsdailybot team get / listde usuárioResolver nomes de time para UUIDs, listar membros
healthdailybot agent healthde agenteAnunciar online/offline, entregar inbox pendente
emaildailybot agent email sendde agenteEnviar um email para um destinatário confirmado
conversationdailybot conversation opende usuárioAbrir ou retomar um thread de DM em grupo
askdailybot askde usuárioConsultar o assistente AI do Dailybot (one-shot ou interativo)
messagesdailybot agent message listde agenteRecuperar mensagens pendentes da equipe para o agente
workflowdailybot workflow list / getde usuárioListar e inspecionar workflows configurados
channelsdailybot channels listde usuárioDescobrir canais de reporte disponíveis

report — updates de progresso

Envolve dailybot agent update. Envia um update tipo standup como o agente, creditando o humano que roda a sessão como co-author quando um token de sessão está presente. Regras: 1–3 frases, WHAT + WHY, apenas inglês — nunca file paths, commit hashes ou branch names.

bash
dailybot agent update "Shipped the pricing refresh — Advanced is now the recommended tier." \
  --name "Cursor agent" \
  --metadata '{"model":"composer-2.5"}'

checkin — standups + authoring

bash
dailybot checkin list          # pending today
dailybot checkin show <uuid>   # config + questions
dailybot checkin complete <uuid>
dailybot checkin history <uuid>

Comandos de authoring (CLI >= 1.17.2):dailybot checkin create,dailybot checkin edit,dailybot checkin reset.

chat — mensagens bot cross-platform

Mesmo comando para Slack, Microsoft Teams, Discord e Google Chat — a plataforma conectada é resolvida no servidor, então a skill nunca precisa saber qual vendor de chat sua equipe usa.

bash
dailybot chat send --to @user "Text goes here"
dailybot chat send --channel "#team" --text "Text goes here"
dailybot chat update <message_uuid> --text "Edited text"

kudos — reconhecimento

bash
dailybot kudos give --to @teammate --message "Good review on #199"
dailybot kudos give --team Engineering --message "Shipped the release form v9"

forms — ciclo de respostas + authoring

bash
dailybot form list                                # forms visible to you
dailybot form get <uuid> --json                   # full payload (questions + states)
dailybot form submit <uuid> --content '{...}'     # create a response
dailybot form transition <uuid> <rid> qa          # advance workflow state
dailybot form response get <uuid> <rid> --json    # read a response

Comandos de authoring (CLI >= 1.17.2):dailybot form create, dailybot form update,dailybot form delete. Consulte areferência da API de Forms para a superfície HTTP subjacente.

teams — resolver nomes para UUIDs

bash
dailybot team list
dailybot team get Engineering       # case-insensitive
dailybot team get <uuid>

Outras sub-skills chamam teams internamente quando precisam traduzir um nome de time — raramente você a invoca direto.

health — heartbeat + inbox

Um health check bem-sucedido entrega qualquer mensagem pendente ao agente, então agentes long-running consultam instruções do time com a mesma chamada que os mantém visíveis no standup.

bash
dailybot agent health --ok --message "All good"
dailybot agent health --fail --message "DB unreachable"
dailybot agent health --status --name "Claude Code"

email — enviar um email

Com consentimento: o destinatário precisa estar pré-confirmado no perfil do agente. Bounces voltam como agent messages para que a skill possa reagir.

bash
dailybot agent email send \
  --to [email protected] \
  --subject "Weekly summary" \
  --body "..."

conversation — DMs em grupo

Abre ou retoma um thread de DM em grupo na plataforma de chat conectada. Se o mesmo conjunto de participantes já tem um thread aberto, a CLI o reutiliza em vez de criar um duplicado.

bash
dailybot conversation open -u @jane @bob -m "Deploy report attached"
dailybot conversation open -u @jane              # reuses existing group if same people

ask — assistente AI

Chat one-shot ou interativo com o AI do Dailybot. Suporta output JSON estruturado para consumo programático, ou um TUI tela cheia quando invocado sem argumentos.

bash
dailybot ask "Summarize this week's standup responses"
dailybot ask --json                               # structured output
dailybot ask                                      # interactive TUI mode

messages — inbox do agente

Recupera mensagens pendentes endereçadas ao agente por membros da equipe. Útil para agentes long-running que precisam consultar instruções humanas entre health checks.

bash
dailybot agent message list --name "Claude Code" --pending

workflow — inspecionar workflows

Listagem e inspeção read-only de workflows configurados no Dailybot. Os agentes usam isso para entender quais automações já estão rodando antes de propor mudanças.

bash
dailybot workflow list
dailybot workflow get <uuid> --json

channels — canais de reporte

Lista os canais de reporte (Slack, Teams, Discord, Google Chat) visíveis para o usuário autenticado. Os agentes chamam isso para descobrir onde entregar relatórios e mensagens.

bash
dailybot channels list --json

.dailybot/profile.json por repo

Identidade + política do repo, commitada. Sem segredos — as credenciais vivem sempre em DAILYBOT_API_KEY ou no token de sessão local.

.dailybot/profile.json
{
  "agent_name": "cursor-agent",
  "default_metadata": {
    "model": "composer-2.5"
  },
  "report": {
    "min_interval_minutes": 20,
    "nudge": {
      "unreported_commits_threshold": 3,
      "sustained_work_minutes": 45
    }
  }
}
  • agent_name — assina cada relatório para que um repo com múltiplos agentes (Cursor + Claude Code) possa ser distinguido no feed do standup.
  • default_metadata — é mesclado em cada payload de dailybot agent update.
  • report.min_interval_minutes — rate-limit do lado skill para relatórios. O servidor também impõe um piso de 30 min.
  • report.nudge.* — limites para os lembretes dos hooks locais (commits sem reportar, trabalho sustentado).

Warning

Nunca adicione um campo key em profile.json. API keys vão em DAILYBOT_API_KEY, nunca em um arquivo que é commitado.

Silenciar por repo

Deixe um arquivo vazio para desativar todos os hooks + telemetria de skill para um repo. Commite se quiser que o silêncio viaje com o repo; deixe local se for só para você.

bash
touch .dailybot/disabled

Hooks de sessão

A skill inclui hooks determinísticos para dois harnesses — ambos são best-effort, locais, e nunca chamam a rede. O ciclo de vida completo é: session-start → activity → post-commit → stop.

HarnessArquivo de hooksEventos
Claude Code.agents/settings.jsonSessionStart, PostToolUse, post-commit, Stop
Cursor.cursor/hooks.jsonsessionStart, afterFileEdit, post-commit, stop

Em session start o hook injeta qualquer login nudge + um resumo do trabalho não reportado de sessões anteriores. Em file edits registra sinais em um ledger local por repo. Em post-commit dispara um sinal mais forte a nível de commit para a heurística de nudge de relatórios. Em stop decide — a partir do ledger — se deve injetar um lembrete de "considere enviar um relatório para o Dailybot" no contexto do agente. Se o lembrete disparar e o agente não tiver nada a dizer,dailybot hook dismiss pausa por uma hora.

Spec completa: hooks.md no repo da skill.

Troubleshooting

Warning

A versão do agent-skill fixa a CLI, não o contrário. Se uma sub-skill começar a falhar após um upgrade da CLI, atualize primeiro a skill (npx skills add DailybotHQ/agent-skill@latest). A CLI >= 1.17.2 é necessária para a superfície de authoring de check-ins/forms.
  • dailybot: command not found — o router caiu no install manual. Rode curl -fsSL https://cli.dailybot.com/install.sh | bash e tente a sub-skill de novo.
  • 401 Unauthorized em qualquer sub-skill — nenhum auth foi resolvido. Rode dailybot login, ou exporte DAILYBOT_API_KEY antes de invocar o agente.
  • A sub-skill não aparece no harness.agents/skills/dailybot-agent/ não está em disco. Rode o comando de install de novo.
  • Rate limit — você excedeu o intervalo de reportes do agente. Diminua a frequência, ou aumente report.min_interval_minutes em .dailybot/profile.json.

Versionamento

ComponenteMínimoRecomendado
dailybot-cli (base)1.10.0>=1.17.2
DailybotHQ/agent-skill1.8.3latest

O router do agent-skill publica um manifest por release; o bootstrap da CLI se fixa contra esse manifest para que um skill pack antigo não puxe uma CLI inesperada.

Aprofundar