Habilidades

Una habilidad es un proceso repetible, paso a paso, diseñado para completar una tarea particular sin la interacción estándar de ida y vuelta.

El Agente A lo lee bajo demanda cuando la tarea coincide con la descripción de la habilidad, y luego sigue las instrucciones que contiene.

Haz clic en Preview para ver las instrucciones reales, qué entrada se requiere de tu parte y un ejemplo de la salida de ejemplo.

Habilidades predefinidas (seleccionadas por Ahrefs)

Agent A ofrece una biblioteca de habilidades en crecimiento, mantenida y actualizada regularmente por el equipo de Ahrefs. A través de ellas, Agent A se ejecuta como un especialista en marketing de clase mundial desde el principio.

Habilidades del espacio de trabajo (tus habilidades)

Un segundo nivel de habilidades reside en tu propio espacio de trabajo bajo ~/workspace/skills/<skill-name>/SKILL.md. Estas son las reglas únicas de tu equipo, producto, voz y flujos de trabajo. Tú las escribes, editas y curadas.

También puedes solicitar en el chat que el archivo de habilidades completo esté en línea para ediciones.

Cómo añadir una nueva habilidad

La forma de la solicitud:

"Crea una habilidad llamada <name> que capture <rules>. La descripción del activador debe ser <one-line>. Ejemplos de referencia: <paste or attach>."

Agente A:

1. Redacta el SKILL.md con las reglas, estructurado para una recuperación fácil.
2. Lo coloca en ~/workspace/skills/<name>/.
3. Lo prueba haciéndose una pregunta representativa y leyendo la habilidad en vuelo.

Cómo actualizar una habilidad

Edición directa de archivos, o "actualiza la habilidad de voz de marca: añade la regla de que nunca usamos guiones largos". El agente añade o revisa en su lugar. El siguiente chat recoge el cambio automáticamente.

Cómo se estructura una habilidad

~/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

El frontmatter de SKILL.md se ve así:

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

La description es lo que el agente compara. Si es vaga, la habilidad no se activará cuando la necesites. Si es precisa, se activa exactamente cuando es relevante.

Cuando el agente utiliza una habilidad

Al iniciar el chat, el agente ve la lista de habilidades disponibles (tanto predefinidas como del espacio de trabajo) más sus descripciones. Cuando una solicitud coincide, lee el cuerpo antes de hacer el trabajo.

• Escribir una landing page → lee ahrefs-brand-voice y ahrefs-design-manual.
• Generar un PDF → lee PDF (obligatorio; el sandbox bloquea varias bibliotecas comunes).
• Llamar a una API de terceros → lee connectors.
• Escribir una página de Console que llame a un LLM → lee llm y pydantic.

También puedes cargar forzosamente una habilidad: "usa la habilidad de voz de marca antes de responder."

Bajo el capó. Las habilidades no son magia. Son markdown que el agente decide leer según una coincidencia de descripción. El costo es la lectura; el beneficio es la consistencia. Las habilidades precompiladas provienen del almacén de solo lectura de la plataforma; las habilidades del espacio de trabajo viven en tu espacio de trabajo y son tuyas para evolucionar. Si una regla necesita aplicarse a un chat, simplemente dilo en el chat. Si necesita aplicarse a cada chat en adelante, ponla en una habilidad o en la memoria.