> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent skills

> Instala los Agent Skills de Syntage antes de construir una integración con un asistente de programación con IA.

Syntage publica un conjunto de [Agent Skills](https://agentskills.io) que guían a los agentes de programación con IA durante el trabajo de integración. Los skills le indican al agente qué documentación consultar y qué verificaciones de seguridad aplicar; esta documentación sigue siendo el contrato canónico del producto y de la API.

<Note>
  Si estás construyendo una integración con Syntage usando un asistente de programación con IA, instálalos primero. Un agente que trabaja sin ellos deducirá endpoints, nombres de campos, opciones de extractores y tipos de eventos — y el código de integración deducido suele ser lo bastante plausible como para pasar revisión aun estando equivocado.
</Note>

Los skills y sus instrucciones están en inglés.

## Instalación

### Clientes de Agent Skills

Instala el repositorio con un cliente compatible con Agent Skills:

```sh theme={null}
npx skills add syntagecom/skills
```

Selecciona los skills relevantes para tu integración cuando se te solicite.

### Claude Code

Agrega el marketplace de Syntage e instala el paquete de skills:

```text theme={null}
/plugin marketplace add syntagecom/skills
/plugin install syntage-skills@syntage
```

## Skills disponibles

| Skill                       | Úsalo para                                                                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `syntage-api`               | Selección de ambiente de la API, autenticación, entidades, colecciones, paginación, filtros, límites de tasa y arquitectura de integración |
| `syntage-entity-onboarding` | Onboarding de entidades embebido, eventos de onboarding, CSP y pruebas en sandbox                                                          |
| `syntage-extractions`       | Iniciar, monitorear, programar y solucionar problemas de extracciones asíncronas                                                           |
| `syntage-webhooks`          | Diseño de endpoints de webhook, verificación de firmas, procesamiento idempotente de eventos y reconciliación                              |

Invoca un skill explícitamente cuando le pidas ayuda a tu agente:

```text theme={null}
Use $syntage-api to add a sandbox Syntage client to this application.
```

## Valores predeterminados de seguridad

Todos los skills aplican la misma base:

* Comienza el desarrollo y las pruebas en [sandbox](/guides/api/environments), donde los datos devueltos son simulados.
* No enviar solicitudes a producción, modificar la configuración de integración de producción ni abrir un flujo de onboarding en vivo sin tu confirmación explícita.
* Mantener las llaves de API, secretos de firma, credenciales de fuentes de datos y autorizaciones de cada ambiente fuera del código fuente, los prompts, los logs y los ejemplos generados.
* Verificar endpoints, campos, filtros, opciones de extractores y tipos de eventos contra la documentación vigente en lugar de adivinar.

## Metadatos de cliente

`SKILL.md` contiene las instrucciones portables y los metadatos de descubrimiento que comparten los clientes de Agent Skills. Los adaptadores de cliente opcionales mejoran la experiencia en productos compatibles sin cambiar esas instrucciones:

* `agents/openai.yaml` proporciona a clientes de OpenAI como Codex nombres para mostrar, descripciones breves y prompts sugeridos.
* `.claude-plugin/marketplace.json` permite instalar los cuatro skills como un paquete de plugin de Claude Code.

Los clientes que no reconocen un adaptador siguen usando `SKILL.md`.

Los skills se mantienen en [github.com/syntagecom/skills](https://github.com/syntagecom/skills).