Habilidades

Uma habilidade é um processo repetível e passo a passo projetado para concluir uma tarefa específica sem a ida e volta padrão.

O Letaido lê sob demanda quando a tarefa corresponde à descrição da habilidade e, em seguida, segue as instruções que ela contém.

Clique em Visualizar para ver as instruções reais, qual entrada é necessária da sua parte e um exemplo da saída de amostra.

Habilidades pré-criadas (selecionadas pela Ahrefs)

O Letaido vem com uma biblioteca crescente de habilidades, mantida e atualizada regularmente pela equipe da Ahrefs. Por meio delas, o Letaido executa como um profissional de marketing de classe mundial desde o início.

Habilidades da área de trabalho (suas habilidades)

Um segundo nível de habilidades fica na sua própria área de trabalho em ~/workspace/skills/<skill-name>/SKILL.md. Essas são as regras exclusivas da sua equipe, produto, voz e fluxos de trabalho. Você as escreve, edita e organiza.

Você também pode pedir no chat para ter o arquivo de habilidade completo inline para edições.

Como adicionar uma nova habilidade

O formato da solicitação:

"Crie uma habilidade chamada <name> que capture <rules>. A descrição do gatilho deve ser <one-line>. Exemplos de referência: <paste or attach>."

Letaido:

Rascunha o SKILL.md com as regras, estruturado para fácil recuperação.
Coloca em ~/workspace/skills/<name>/.
Testa fazendo uma pergunta representativa e lendo a habilidade durante o processo.

Como atualizar uma habilidade

Edição direta de arquivo, ou "atualize a habilidade de voz da marca: adicione a regra de que nunca usamos travessões". O agente anexa ou revisa no local. O próximo chat detecta a mudança automaticamente.

Como uma habilidade é estruturada

~/workspace/skills/<skill-name>/
  SKILL.md            ← required; description in frontmatter, body is the playbook
  reference.md        ← optional supporting docs
  examples/...        ← optional examples
  assets/...          ← optional images, templates, CSS

O frontmatter do SKILL.md tem a seguinte aparência:

---
name: ahrefs-brand-voice
description: Voice rules and review checklist for any Ahrefs copy. Load when writing or reviewing copy for landing pages, emails, ads, video scripts, or briefs.
---

A description é o que o agente compara. Se for vaga, a habilidade não será acionada quando você quiser. Se for precisa, ela é ativada exatamente quando relevante.

Quando o agente usa uma habilidade

No início do chat, o agente vê a lista de habilidades disponíveis (tanto pré-criadas quanto da área de trabalho) e suas descrições. Quando uma solicitação corresponde, ele lê o corpo antes de realizar o trabalho.

Escrever uma landing page → lê ahrefs-brand-voice e ahrefs-design-manual.
Gerar um PDF → lê PDF (obrigatório; a sandbox bloqueia várias bibliotecas comuns).
Chamar uma API de terceiros → lê connectors.
Escrever uma página do Console que chama um LLM → lê llm e pydantic.

Você também pode forçar o carregamento de uma habilidade: "use a habilidade de voz da marca antes de responder."

Nos bastidores. As habilidades não são mágicas. Elas são markdown que o agente decide ler com base em uma correspondência de descrição. O custo é a leitura; o benefício é a consistência. As habilidades pré-criadas vêm da loja somente leitura da plataforma; as habilidades da área de trabalho ficam na sua área de trabalho e são suas para evoluir. Se uma regra precisa se aplicar a um chat, basta dizê-la no chat. Se ela precisa se aplicar a todos os chats daqui para frente, coloque-a em uma habilidade ou na memória.