Skip to main content

Agent Skills

Agent skills are SKILL.md files that an AI coding agent loads when a task matches them. The skills below package the rules of the Unofficial Star Citizen API (authentication, quota, endpoints, error handling) so an agent writes integration code the same way the documentation describes.

SkillFor
unofficial-star-citizen-api-integrationNew integrations — build features on v2, with types taken from the OpenAPI spec
unofficial-star-citizen-api-v2-migrationExisting v1 users — port a v1 integration to v2

Installation​

A skill is a folder containing a SKILL.md file. Claude Code reads skills from two places:

ScopeFolder
Personal, all projects~/.claude/skills/<skill-name>/SKILL.md
One project, shared through Git.claude/skills/<skill-name>/SKILL.md

Other agents that support the Agent Skills format read the same file: place it in the skills folder documented by that agent. Once installed, the agent picks the skill up automatically when a request matches its description, for example "show the members of an organization with the Star Citizen API".

note

The skills contain no API key.

They tell the agent to read the key from configuration and to keep it server-side. The files can be committed to a public repository.

API Integration​

Guides new code on v2: endpoint choice, the response envelope, quota-safe use of ?refresh=true, status-code handling, ETag caching and a minimal typed client.

Download SKILL.mdView raw

Personal (all projects)
mkdir -p ~/.claude/skills/unofficial-star-citizen-api-integration && curl -fsSL https://starcitizen-api.com/skills/unofficial-star-citizen-api-integration/SKILL.md -o ~/.claude/skills/unofficial-star-citizen-api-integration/SKILL.md
Project (commit it with the code)
mkdir -p .claude/skills/unofficial-star-citizen-api-integration && curl -fsSL https://starcitizen-api.com/skills/unofficial-star-citizen-api-integration/SKILL.md -o .claude/skills/unofficial-star-citizen-api-integration/SKILL.md
tip

Types come from the OpenAPI spec.

The skill tells the agent to read the OpenAPI document for exact parameters and response schemas before writing types and parsers, instead of guessing them.

v1 to v2 Migration​

Converts every v1 call (/{apikey}/v1/{mode}/...) to its v2 equivalent: moves the key to the x-api-key header, translates live / eager / cache / auto to ?refresh=true or a free cached read, renames paths and parameters, fixes error handling and flags the payload fields that changed shape. It follows the Migration Guide and the v1 → v2 Mapping Reference.

Download SKILL.mdView raw

Personal (all projects)
mkdir -p ~/.claude/skills/unofficial-star-citizen-api-v2-migration && curl -fsSL https://starcitizen-api.com/skills/unofficial-star-citizen-api-v2-migration/SKILL.md -o ~/.claude/skills/unofficial-star-citizen-api-v2-migration/SKILL.md
Project (commit it with the code)
mkdir -p .claude/skills/unofficial-star-citizen-api-v2-migration && curl -fsSL https://starcitizen-api.com/skills/unofficial-star-citizen-api-v2-migration/SKILL.md -o .claude/skills/unofficial-star-citizen-api-v2-migration/SKILL.md
warning

v1 is no longer maintained.

It receives no new features, no bug fixes and no support, and will be removed in a future release. See the Changelog.

For the rules the skills apply, see Rate Limits & Quota, Response Format and Error Codes.