Skills de IA de Content Island
Skill de Content Island para la Client API (AI Tools)
Definición del skill (fuente de la verdad)
🔗 https://github.com/content-island/content-island-ai-skill/blob/main/skill.md
Este archivo es la fuente autoritativa del skill de IA de Content Island.
Define exactamente qué pueden hacer las herramientas de IA, qué documentación pueden usar y cómo deben comportarse.
Content Island proporciona una definición de skill para IA que permite a las herramientas de desarrollo asistidas por IA interactuar de forma segura y precisa con la Client API de Content Island.
Este skill está diseñado para evitar alucinaciones y garantizar que todo el código y las explicaciones generadas estén estrictamente basadas en la documentación oficial de Content Island.
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:
contentTypelanguagefields.*paginationsortincludeRelatedContent
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.