Cria conjuntos de instruções reutilizáveis para workflows especializados. Define workflows personalizados, adiciona ficheiros de suporte e ensina ao Bob tarefas especializadas para resultados consistentes.

Os skills são conjuntos de instruções reutilizáveis que ensinam ao Bob novos workflows e tarefas especializadas. Pensa neles como receitas que Bob segue para completar tipos específicos de trabalho de forma consistente e repetível.

Porquê usar skills

Reutilização: Define workflows uma vez e usa-os em múltiplas conversas.

Consistência: Garante que Bob segue a mesma abordagem sempre que executa tarefas específicas.

Especialização: Cria expertise específica de domínio para revisões de código, testes, documentação e mais.

Colaboração em equipa: Partilha workflows padronizados com a tua equipa através do controlo de versões.

Flexibilidade: Inclui ficheiros de suporte como checklists, templates e materiais de referência.

Como funcionam os skills

Quando ativas um skill, Bob recebe as instruções do skill e obtém acesso a quaisquer ficheiros de suporte no diretório do skill. Bob segue então estas instruções para completar a tua tarefa de acordo com o workflow definido.

Os skills carregam uma vez por conversa para evitar prompts duplicados. Bob determina automaticamente quando ativar um skill com base no teu pedido e na descrição do skill.

Criar um skill

Configuração básica

Cria uma pasta dentro de .bob/skills/ na raiz do teu projeto, ou usa ~/.bob/skills/ para skills globais.

Adiciona um ficheiro SKILL.md dentro dessa pasta.

Estrutura exemplo:

SKILL.md

Formato de SKILL.md

O ficheiro SKILL.md usa frontmatter YAML seguido das instruções do skill:

---
name: code-review
description: Review code for bugs, security issues, and best practices
---

When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code

Provide a summary with severity levels for each finding.

Campos obrigatórios:

name: O nome de exibição do skill usado na interface do Bob

description: Um resumo claro que ajuda Bob a decidir quando ativar este skill — skills sem descrições são ignorados

Secção de instruções: Tudo abaixo do delimitador --- torna-se as instruções que Bob recebe quando o skill é ativado.

Adicionar ficheiros de suporte

Podes incluir ficheiros adicionais e subpastas junto ao SKILL.md para fornecer materiais de referência, templates, checklists, scripts ou outros recursos. Bob pode ler estes ficheiros automaticamente assim que o skill é ativado.

Exemplo com ficheiros de suporte:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

Os ficheiros e pastas de suporte podem incluir:

Checklists e templates

Documentação de referência

Exemplos de configuração

Scripts e utilitários em subpastas

Guias de estilo

Quaisquer outros recursos necessários para o skill

Localizações dos skills

Os skills podem ser definidos em dois níveis:

Localização	Âmbito	Caso de uso
`<project>/.bob/skills/`	Específico do projeto	Workflows exclusivos deste projeto
`~/.bob/skills/`	Global	Workflows pessoais ou de toda a organização

Prioridade: Se ambas as localizações contiverem um skill com o mesmo nome, o skill ao nível do projeto tem precedência.

Aprovar skills

Por predefinição, Bob pede a tua permissão antes de ativar um skill. Isto dá-te controlo sobre quando os workflows especializados são aplicados.

Para saltar o prompt de aprovação:

Abre as definições do Bob.

Navega para a secção de Aprovação automática.

Ativa o toggle para Skills.

Com esta definição ativada, Bob ativa skills automaticamente quando apropriado sem pedir permissão.

Separador de definições de Skills

O separador Skills nas definições do Bob dá-te um local central para ver e gerir os skills disponíveis no teu workspace. Usa-o para ver quais skills estão carregados, verificar as suas localizações e confirmar que skills dos teus diretórios de projeto ou globais estão a ser detetados corretamente.

Escrever skills eficazes

Descrições claras

Escreve descrições que indiquem claramente quando o skill deve ser usado. Bob baseia-se nestas descrições para determinar a relevância do skill.

Bem: "Review code for bugs, security issues, and best practices"

Evitar: "Code review skill"

Instruções focadas

Mantém o ficheiro SKILL.md principal focado no workflow principal. Move o material de referência detalhado, exemplos e checklists para ficheiros de suporte.

Exemplo:

---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---

Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses

Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.

Passos acionáveis

Estrutura as instruções como passos claros e acionáveis que Bob pode seguir sistematicamente.

Exemplo:

---
name: feature-implementation
description: Implement new features following team standards
---

<Steps>
<Step>
Review the feature requirements.

</Step>

<Step>
Create a plan with file changes needed.

</Step>

<Step>
Implement the feature with tests.

</Step>

<Step>
Update documentation.

</Step>

<Step>
Verify all tests pass.

</Step>
</Steps>

Follow coding standards in `coding-standards.md`.

Skills de exemplo

Skill de revisão de código

---
name: security-review
description: Review code for security vulnerabilities and best practices
---

Perform a security-focused code review:

<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure

</Step>

<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling

</Step>

<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards

</Step>
</Steps>

Use the severity guide in `severity-levels.md` for classification.

Skill de documentação

---
name: api-docs
description: Generate comprehensive API documentation
---

Create API documentation that includes:

<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning

</Step>

<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses

</Step>

<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination

</Step>
</Steps>

Follow the template in `api-doc-template.md` and examples in `api-examples.md`.

Dicas e boas práticas

Começa de forma simples: Começa com instruções básicas e refina com base nos resultados.

Usa ficheiros de suporte: Mantém SKILL.md conciso movendo o conteúdo detalhado para ficheiros complementares.

Testa exaustivamente: Verifica que os skills funcionam como esperado antes de partilhá-los com a tua equipa.

Controlo de versões: Inclui skills do projeto no teu repositório para consistência da equipa.

Nomes claros: Usa nomes de skills descritivos que indiquem o seu propósito.

Responsabilidade única: Cria skills focados para tarefas específicas em vez de tentar lidar com múltiplos workflows não relacionados.

Skills

Nesta página