Skip to content
Content Island logo Content Island logo Docs

Content Island AI Skills

Content Island Client API Skill (AI Tools)

Skill definition (source of truth)

🔗 https://github.com/content-island/content-island-ai-skill/blob/main/skill.md

This file is the authoritative source for the Content Island AI skill.
It defines exactly what AI tools are allowed to do, which documentation they can use, and how they must behave.

Content Island provides an AI skill definition that enables AI coding tools to interact safely and accurately with the Content Island Client API.

This skill is designed to prevent hallucinations and ensure that all generated code and explanations are strictly grounded in the official Content Island documentation.

What this skill does

The Content Island Client API skill instructs AI tools to:

  • Generate examples only using the official JavaScript client
    (@content-island/api-client)
  • Explain API usage exclusively based on documented behavior
  • Avoid guessing, inferring, or inventing parameters, defaults, or endpoints
  • Explicitly state when something is not documented instead of speculating

Accuracy always takes priority over completeness.

What the skill allows

The skill explicitly allows AI tools to work with the following documented API surface:

  • Client creation (createClient)
  • Content queries (getContentList, getContent)
  • Raw content queries (getRawContentList, getRawContent)
  • Content mapping (mapContentToModel)
  • Documented query options such as:
    • contentType
    • language
    • fields.*
    • pagination
    • sort
    • includeRelatedContent

It also enforces best practices, including:

  • Treating access tokens as secrets
  • Using environment variables instead of hard-coded values
  • Using preview tokens (PREVIEW_) only when documented

What the skill does NOT allow

The skill explicitly forbids:

  • Using undocumented REST endpoints
  • Inferring behavior from other CMSs or SDKs
  • Making assumptions based on “common patterns”
  • Filling gaps in documentation with guesswork
  • Using third-party tutorials, blog posts, or issues as sources

If something is unclear or undocumented, the AI must clearly state that.

Supported AI tools

The skill can be used by AI tools that support external or repository-based instruction files, including:

  • GitHub Copilot (Chat, Inline, Copilot Workspace)
  • Claude Code
  • Other AI coding assistants that support custom instruction files

Because the skill is defined declaratively in Markdown, it can be reused across different tools while keeping behavior consistent.

Why this exists

AI tools are powerful, but when working with APIs, incorrect assumptions are worse than no answer.

This skill exists to ensure that:

  • Generated code is safe to copy and run
  • API usage always matches the official documentation
  • Developers can trust AI output when working with Content Island

In short:

No documentation → no answer.