Client API Skill

Skill de Content Island para la Client API

Content Island proporciona una definición de skill para IA que permite a las herramientas de desarrollo asistidas por IA —GitHub Copilot, Claude Code y otros asistentes que soportan archivos de instrucciones a nivel de repositorio— interactuar de forma segura y precisa con la Client API de Content Island (@content-island/api-client).

El skill está diseñado para evitar alucinaciones: cada ejemplo y explicación generada está estrictamente basada en la documentación oficial de Content Island, nunca en conjeturas, parámetros inferidos ni patrones tomados de otros CMS.

Su definición es la fuente autoritativa de lo que las herramientas de IA pueden hacer, qué documentación pueden usar y cómo deben comportarse:

🔗 https://github.com/content-island/content-island-ai-skill/blob/main/skills/content-island-client-api/SKILL.md

Instalación

Los skills de Content Island están publicados en npm y se instalan en la carpeta .claude/skills/ de tu proyecto, donde Claude Code los detecta automáticamente — no hace falta instalación global.

La forma más sencilla es el selector interactivo, que lista todos los skills preseleccionados; deselecciona los que no quieras y pulsa enter:

npx @content-island/ai-skills

Para instalar solo el skill de la Client API directamente:

npx @content-island/ai-skills install content-island-client-api

Otras opciones en modo comando:

# Listar los skills disponibles
npx @content-island/ai-skills list

# Instalar todos los skills
npx @content-island/ai-skills install all

# Sobrescribir un skill ya instalado
npx @content-island/ai-skills install content-island-client-api --force

El skill se instala en .claude/skills/content-island-client-api/SKILL.md. Requiere Node.js 18 o superior.

Qué hace este skill

El skill de la Client API de Content Island indica a las herramientas de IA que deben:

Generar ejemplos solo usando el cliente JavaScript oficial
(@content-island/api-client)
Explicar el uso de la API exclusivamente según el comportamiento documentado
Evitar adivinar, inferir o inventar parámetros, valores por defecto o endpoints
Indicar explícitamente cuando algo no está documentado en lugar de especular

La precisión siempre tiene prioridad sobre la completitud.

Qué permite el skill

El skill permite explícitamente trabajar con la siguiente superficie de API documentada:

Creación del cliente (createClient)
Consultas de contenido (getContentList, getContent)
Consultas de contenido en bruto (getRawContentList, getRawContent)
Mapeo de contenido (mapContentToModel)
Opciones de consulta documentadas como:
- contentType
- language
- fields.*
- pagination
- sort
- includeRelatedContent

Además, refuerza buenas prácticas como:

Tratar los access tokens como secretos
Usar variables de entorno en lugar de valores hardcodeados
Usar preview tokens (PREVIEW_) solo cuando está documentado

Qué NO permite el skill

El skill prohíbe explícitamente:

Usar endpoints REST no documentados
Inferir comportamientos a partir de otros CMS o SDKs
Hacer suposiciones basadas en “patrones comunes”
Rellenar huecos en la documentación con conjeturas
Usar tutoriales, blogs o issues de terceros como fuente

Si algo no está claro o no está documentado, la IA debe indicarlo claramente.

Herramientas de IA compatibles

El skill puede ser utilizado por herramientas de IA que soportan archivos de instrucciones externas o a nivel de repositorio, incluyendo:

GitHub Copilot (Chat, Inline, Copilot Workspace)
Claude Code
Otras herramientas de IA para desarrollo que soporten instrucciones personalizadas

Al estar definido de forma declarativa en Markdown, el comportamiento es consistente entre herramientas y compartido por todo el equipo.

Por qué existe

Las herramientas de IA son muy potentes, pero cuando se trabaja con APIs, una suposición incorrecta es peor que no tener respuesta.

Este skill existe para garantizar que:

El código generado sea seguro de copiar y ejecutar
El uso de la API coincida siempre con la documentación oficial
Los desarrolladores puedan confiar en las respuestas de la IA al trabajar con Content Island

En resumen:

Sin documentación → sin respuesta.