Crea conjuntos de instrucciones reutilizables para workflows especializados. Define workflows personalizados, añade archivos de soporte y enseña a Bob tareas especializadas para obtener resultados consistentes.

Los skills son conjuntos de instrucciones reutilizables que enseñan a Bob nuevos workflows y tareas especializadas. Piensa en ellos como recetas que Bob sigue para completar tipos específicos de trabajo de manera consistente y repetible.

Por qué usar skills

Reutilización: Define workflows una vez y úsalos en múltiples conversaciones.

Consistencia: Asegura que Bob siga el mismo enfoque cada vez para tareas específicas.

Especialización: Crea experiencia específica de dominio para revisiones de código, testing, documentación y más.

Colaboración en equipo: Comparte workflows estandarizados con tu equipo a través del control de versiones.

Flexibilidad: Incluye archivos de soporte como checklists, plantillas y materiales de referencia.

Cómo funcionan los skills

Cuando activas un skill, Bob recibe las instrucciones del skill y obtiene acceso a cualquier archivo de soporte en el directorio del skill. Bob luego sigue estas instrucciones para completar tu tarea según el workflow definido.

Los skills se cargan una vez por conversación para evitar prompts duplicados. Bob determina automáticamente cuándo activar un skill basándose en tu solicitud y la descripción del skill.

Crear un skill

Configuración básica

Crea una carpeta dentro de .bob/skills/ en la raíz de tu proyecto, o usa ~/.bob/skills/ para skills globales.

Añade un archivo SKILL.md dentro de esa carpeta.

Estructura de ejemplo:

SKILL.md

Formato de SKILL.md

El archivo SKILL.md usa frontmatter YAML seguido de las instrucciones del 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 obligatorios:

name: El nombre para mostrar del skill en la interfaz de Bob

description: Un resumen claro que ayuda a Bob a decidir cuándo activar este skill — los skills sin descripciones se ignoran

Sección de instrucciones: Todo lo que está debajo del delimitador --- se convierte en las instrucciones que Bob recibe cuando el skill se activa.

Añadir archivos de soporte

Puedes incluir archivos adicionales y subcarpetas junto a SKILL.md para proporcionar materiales de referencia, plantillas, checklists, scripts u otros recursos. Bob puede leer estos archivos automáticamente una vez que el skill se activa.

Ejemplo con archivos de soporte:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

Los archivos y carpetas de soporte pueden incluir:

Checklists y plantillas

Documentación de referencia

Ejemplos de configuración

Scripts y utilidades en subcarpetas

Guías de estilo

Cualquier otro recurso necesario para el skill

Ubicaciones de skills

Los skills se pueden definir en dos niveles:

Ubicación	Alcance	Caso de uso
`<project>/.bob/skills/`	Específico del proyecto	Workflows únicos de este proyecto
`~/.bob/skills/`	Global	Workflows personales o de toda la organización

Prioridad: Si ambas ubicaciones contienen un skill con el mismo nombre, el skill a nivel de proyecto tiene prioridad.

Aprobar skills

De forma predeterminada, Bob solicita tu permiso antes de activar un skill. Esto te da control sobre cuándo se aplican los workflows especializados.

Para omitir el prompt de aprobación:

Abre la configuración de Bob.

Navega a la sección de Aprobación automática.

Activa el toggle para Skills.

Con esta configuración habilitada, Bob activa skills automáticamente cuando es apropiado sin solicitar permiso.

Pestaña de configuración de Skills

La pestaña Skills en la configuración de Bob te ofrece un lugar central para ver y gestionar los skills disponibles en tu workspace. Úsala para ver qué skills están cargados, verificar sus ubicaciones y confirmar que los skills de tus directorios de proyecto o globales se están detectando correctamente.

Escribir skills efectivos

Descripciones claras

Escribe descripciones que indiquen claramente cuándo debe usarse el skill. Bob se basa en estas descripciones para determinar la relevancia del skill.

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

Evitar: "Code review skill"

Instrucciones enfocadas

Mantén el archivo SKILL.md principal enfocado en el workflow principal. Mueve el material de referencia detallado, ejemplos y checklists a archivos de soporte.

Ejemplo:

---
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`.

Pasos accionables

Estructura las instrucciones como pasos claros y accionables que Bob pueda seguir sistemáticamente.

Ejemplo:

---
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 ejemplo

Skill de revisión 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 documentación

---
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`.

Consejos y buenas prácticas

Empieza simple: Comienza con instrucciones básicas y refina según los resultados.

Usa archivos de soporte: Mantén SKILL.md conciso moviendo el contenido detallado a archivos complementarios.

Prueba exhaustivamente: Verifica que los skills funcionen como se espera antes de compartirlos con tu equipo.

Control de versiones: Incluye los skills del proyecto en tu repositorio para la consistencia del equipo.

Nombres claros: Usa nombres de skills descriptivos que indiquen su propósito.

Responsabilidad única: Crea skills enfocados para tareas específicas en lugar de intentar manejar múltiples workflows no relacionados.

Skills

En esta página