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
.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:
curl -fsSL https://cli.dailybot.com/install.sh | bash
npx skills add DailybotHQ/agent-skillClaude Code · Cursor · OpenAI Codex CLI · Gemini CLI
Agentes baseados em npm leem .agents/skills/ diretamente. Um único comando basta:
npx skills add DailybotHQ/agent-skillGitHub Copilot · Cline · Windsurf
Qualquer harness que leia .agents/skills/ funciona. Clone a skill no lugar:
git clone https://github.com/DailybotHQ/agent-skill \
.agents/skills/dailybot-agentManual
git clone https://github.com/DailybotHQ/agent-skill
cd agent-skill && ./setup.shInfo
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/.
<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).
| Origem | Setup | Caso de uso |
|---|---|---|
dailybot login | OTP por email interativo | Máquinas de developer, rodadas ad-hoc |
DAILYBOT_API_KEY | Variável de ambiente | CI, agentes não atendidos, runners headless |
Precedência: DAILYBOT_API_KEY vence quando ambas estão definidas. Verifique a credencial resolvida com:
dailybot status --authDetalhes 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-skill | Comando CLI | Auth | Propósito |
|---|---|---|---|
report | dailybot agent update | de agente | Postar um update tipo standup de 1–3 frases |
checkin | dailybot checkin … | de usuário | Listar / completar check-ins pendentes; authoring |
chat | dailybot chat send / update | usuário ou org key | Enviar + editar mensagens bot no Slack/Teams/Discord/Google Chat |
kudos | dailybot kudos give | de usuário | Reconhecer um teammate ou um time inteiro |
forms | dailybot form … | de usuário | Ciclo completo de respostas + authoring de forms |
teams | dailybot team get / list | de usuário | Resolver nomes de time para UUIDs, listar membros |
health | dailybot agent health | de agente | Anunciar online/offline, entregar inbox pendente |
email | dailybot agent email send | de agente | Enviar um email para um destinatário confirmado |
conversation | dailybot conversation open | de usuário | Abrir ou retomar um thread de DM em grupo |
ask | dailybot ask | de usuário | Consultar o assistente AI do Dailybot (one-shot ou interativo) |
messages | dailybot agent message list | de agente | Recuperar mensagens pendentes da equipe para o agente |
workflow | dailybot workflow list / get | de usuário | Listar e inspecionar workflows configurados |
channels | dailybot channels list | de usuário | Descobrir 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.
dailybot agent update "Shipped the pricing refresh — Advanced is now the recommended tier." \
--name "Cursor agent" \
--metadata '{"model":"composer-2.5"}'checkin — standups + authoring
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.
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
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
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 responseComandos 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
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.
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.
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.
dailybot conversation open -u @jane @bob -m "Deploy report attached"
dailybot conversation open -u @jane # reuses existing group if same peopleask — 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.
dailybot ask "Summarize this week's standup responses"
dailybot ask --json # structured output
dailybot ask # interactive TUI modemessages — 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.
dailybot agent message list --name "Claude Code" --pendingworkflow — 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.
dailybot workflow list
dailybot workflow get <uuid> --jsonchannels — 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.
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.
{
"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 dedailybot 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
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ê.
touch .dailybot/disabledHooks 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.
| Harness | Arquivo de hooks | Eventos |
|---|---|---|
| Claude Code | .agents/settings.json | SessionStart, PostToolUse, post-commit, Stop |
| Cursor | .cursor/hooks.json | sessionStart, 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
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. Rodecurl -fsSL https://cli.dailybot.com/install.sh | bashe tente a sub-skill de novo.401 Unauthorizedem qualquer sub-skill — nenhum auth foi resolvido. Rodedailybot login, ou exporteDAILYBOT_API_KEYantes 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 aumentereport.min_interval_minutesem.dailybot/profile.json.
Versionamento
| Componente | Mínimo | Recomendado |
|---|---|---|
dailybot-cli (base) | 1.10.0 | >=1.17.2 |
DailybotHQ/agent-skill | 1.8.3 | latest |
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
- Overview de marketing em /skills/agent-skill — catálogo de sub-skills, features, FAQ
- Repo da skill no GitHub
- Referência da CLI do Dailybot
- Autenticação
- Referência da API