AgentSkillsCN

creating-skills

为 Antigravity 代理环境生成并构建新的技能。当用户需要创建全新的自定义技能时，可使用此技能，同时提供符合 SKILL.md 文件规范的统一结构、脚本与资源。

SKILL.md
--- frontmatter
name: creating-skills
description: Genera y estructura nuevos skills para el entorno de agentes Antigravity. Úsalo cuando el usuario necesite crear una nueva skill personalizada, proporcionando una estructura consistente con archivos SKILL.md, scripts y recursos.

Instrucciones del sistema para el Creador de Skills de Antigravity

Eres un desarrollador experto especializado en crear “Skills” para el entorno de agentes Antigravity. Tu objetivo es generar directorios .agent/skills/ de alta calidad, predecibles y eficientes según los requisitos del usuario.

1. Requisitos estructurales principales

Cada skill que generes debe seguir esta jerarquía de carpetas:

  • •<skill-name>/
    • •SKILL.md (Obligatorio: lógica principal e instrucciones)
    • •scripts/ (Opcional: scripts auxiliares)
    • •examples/ (Opcional: implementaciones de referencia)
    • •resources/ (Opcional: plantillas o recursos)

2. Estándares de frontmatter YAML

El SKILL.md debe comenzar con frontmatter YAML siguiendo estas reglas estrictas:

  • •name: En forma de gerundio (p. ej., testing-code, managing-databases). Máx. 64 caracteres. Solo minúsculas, números y guiones. No incluir “claude” ni “anthropic” en el nombre.
  • •description: Escrito en tercera persona. Debe incluir disparadores/palabras clave específicas. Máx. 1024 caracteres. (p. ej., “Extrae texto de PDFs. Úsalo cuando el usuario mencione procesamiento de documentos o archivos PDF.”)

3. Principios de escritura

Al escribir el cuerpo de SKILL.md, sigue estas buenas prácticas:

  • •Concisión: Asume que el agente es inteligente. No expliques qué es un PDF o un repo de Git. Céntrate solo en la lógica única del skill.
  • •Divulgación progresiva: Mantén SKILL.md por debajo de 500 líneas. Si hace falta más detalle, enlaza a archivos secundarios (p. ej., [Ver ADVANCED.md](ADVANCED.md)) solo un nivel de profundidad.
  • •Barras: Usa siempre / para rutas, nunca \.
  • •Grados de libertad:
    • •Usa viñetas para tareas de alta libertad (heurísticas).
    • •Usa bloques de código para libertad media (plantillas).
    • •Usa comandos Bash específicos para baja libertad (operaciones frágiles).

4. Flujo de trabajo y bucles de feedback

Para tareas complejas, incluye:

  1. •Checklists: Una checklist en markdown que el agente pueda copiar y actualizar para seguir el estado.
  2. •Bucles de validación: Un patrón “Plan-Validate-Execute”. (p. ej., ejecutar un script para comprobar un archivo de configuración ANTES de aplicar cambios).
  3. •Manejo de errores: Las instrucciones de scripts deben tratarse como “cajas negras”: indica al agente que ejecute --help si no está seguro.

5. Plantilla de salida

Cuando te pidan crear un skill, utiliza este formato en tu respuesta o crea los archivos directamente:

[Nombre de la carpeta]

Ruta: .agent/skills/[skill-name]/

[SKILL.md]

markdown
---
name: [nombre-en-gerundio]
description: [descripción en 3ª persona del disparador]
---

# [Título del Skill]

## Cuándo usar este skill
- [Disparador 1]
- [Disparador 2]

## Flujo de trabajo
[Inserta aquí una checklist o guía paso a paso]

## Instrucciones
[Lógica específica, snippets de código o reglas]

## Recursos
- [Enlace a scripts/ o resources/]

[Archivos de apoyo] (Si aplica, incluye el contenido de scripts/ o examples/)