Codex: Agent Skills do Codex

Última atualização: 2026-08-31

Agent Skills dão ao Codex expertise específica de domínio, similar a certificações profissionais para humanos.

📋 Pré-requisitos: Compreensão das operações básicas e configuração do Codex

1. O Que Você Vai Aprender

• Conceitos de Agent Skills
• Skills Embutidos
• Skills Personalizados
• Marketplace de Skills

2. O Que São Agent Skills

Agent Skills são módulos de extensão de capacidade do Codex. Cada Skill encapsula conhecimento e fluxos de trabalho específicos de domínio.

3. Skills Embutidos

O Codex inclui vários Skills comumente usados:

(1) Usando Skills Embutidos

> /skill code-review
> Review the code quality of src/auth.ts

> /skill debug
> Fix TypeError: Cannot read property 'id' of undefined

▶ Exemplo 1: Alice Usa Skills Embutidos

# Alice usa o Skill de security para uma auditoria de segurança
> /skill security
> Scan the entire project for security vulnerabilities

# Saída:
# 🔴 [Critical] src/auth.ts:45 - Hardcoded secret key
# 🟡 [Medium] src/api.ts:23 - SQL concatenation not parameterized
# 🟢 [Low] src/utils.ts:12 - Missing input validation

4. Skills Personalizados

(1) Criar um Arquivo de Skill

<!-- .codex/skills/react-component.md -->

# React Component Generator

## Role
You are a React component development expert, proficient in TypeScript and modern React patterns.

## Rules
- Use functional components
- Use TypeScript type annotations
- Define Props with interface
- Use CSS Modules or Tailwind
- Include Storybook story
- Include unit tests

## Workflow
1. Analyze component requirements
2. Define Props interface
3. Implement component logic
4. Add styles
5. Create Storybook story
6. Write unit tests
7. Verify TypeScript compilation

## Output Format
- Component file: src/components/ComponentName.tsx
- Style file: src/components/ComponentName.module.css
- Story file: src/components/ComponentName.stories.tsx
- Test file: src/components/ComponentName.test.tsx

(2) Usando um Skill Personalizado

> /skill react-component
> Create a DatePicker component with date range selection support

▶ Exemplo 2: Bob Cria um Skill Personalizado

<!-- .codex/skills/api-endpoint.md -->

# API Endpoint Generator

## Role
You are a FastAPI endpoint development expert.

## Rules
- Use Pydantic models for request/response validation
- All endpoints include error handling
- Use dependency injection
- Include Swagger documentation
- Write pytest tests

## Template
Reference src/api/templates/standard_endpoint.py

## Workflow
1. Define Pydantic request model
2. Define Pydantic response model
3. Implement endpoint logic
4. Add error handling
5. Write tests
6. Ensure pytest passes

5. Gerenciamento de Skills

(1) Listar Skills

/skills list

(2) Ver Detalhes do Skill

/skills info code-review

(3) Habilitar/Desabilitar Skills

/skills enable react-component
/skills disable doc-gen

(4) Instalar do Marketplace

/skills install graphql-api

6. Melhores Práticas de Skills

❓ Perguntas Frequentes

P: Qual a diferença entre Skills e AGENTS.md? R: AGENTS.md é regras em nível de projeto (aplica-se a todas as tarefas); Skills são extensões de capacidade opcionais (ativadas sob demanda).

P: Posso compartilhar Skills? R: Sim. Commite arquivos de Skill no repositório e membros da equipe os receberão automaticamente. Você também pode publicar no marketplace de Skills.

P: Skills aumentam o consumo de tokens? R: Sim. System prompts de Skills ocupam espaço da janela de contexto, mas são mais eficientes do que descrever repetidamente sem um Skill.

P: Skills embutidos podem ser modificados? R: Não diretamente, mas você pode criar um Skill personalizado com o mesmo nome para sobrescrever a versão embutida.

P: Uma tarefa pode usar múltiplos Skills? R: Não recomendado. Cada tarefa deve usar apenas um Skill para evitar conflitos de instruções.

📖 Resumo

• Skills são módulos de extensão de capacidade do Codex
• Skills embutidos: code-review / debug / test-gen / doc-gen / refactor / security
• Skills personalizados: colocados no diretório .codex/skills/
• Skills contêm: definição de papel + regras + fluxo de trabalho + formato de saída
• Domínio único, incluir templates, fluxo de trabalho claro

📝 Exercícios

1. Básico (⭐): Complete uma tarefa usando um Skill embutido, compare resultados sem Skill.
2. Intermediário (⭐⭐): Crie um Skill personalizado para seus cenários comuns de desenvolvimento.
3. Avançado (⭐⭐⭐): Crie uma biblioteca completa de Skills cobrindo todos os cenários de desenvolvimento da sua equipe.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós