Skip to content
Content Island logo Content Island logo Docs

Content Island AI Skills

Content Island Client API Skill

Content Island provides an AI skill definition that enables AI coding tools — GitHub Copilot, Claude Code, and other assistants that support repository-based instruction files — to interact safely and accurately with the Content Island Client API (@content-island/api-client).

The skill is designed to prevent hallucinations: every generated example and explanation is strictly grounded in the official Content Island documentation, never in guesses, inferred parameters, or patterns borrowed from other CMSs.

Its definition is the authoritative source for what AI tools may do, which documentation they can use, and how they must behave:

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

Installation

The Content Island skills are published to npm and install into your project’s .claude/skills/ folder, where Claude Code detects them automatically — no global install is needed.

The easiest way is the interactive selector, which lists every skill pre-selected; unselect the ones you don’t want and press enter:

Terminal window
npx @content-island/ai-skills

To install just the Client API skill directly:

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

Other command-mode options:

Terminal window
# List the available skills
npx @content-island/ai-skills list


# Install every skill
npx @content-island/ai-skills install all


# Overwrite an already-installed skill
npx @content-island/ai-skills install content-island-client-api --force

The skill lands at .claude/skills/content-island-client-api/SKILL.md. Requires Node.js 18 or newer.

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.