[Vendor] [Topic]

Overview

One short paragraph: what this domain is and what an MSP does with it.

Anti-triggers

Where this skill gets loaded by mistake, and what to load instead. One bullet per case, each naming the correct destination skill:

• [Neighbouring concern] — use [vendor]-[other-skill] instead.
• [Adjacent vendor with overlapping vocabulary] — this skill only speaks the [Vendor] API.

Include this section only when a real routing mistake exists: a sibling skill in the same plugin covering an adjacent entity, or another vendor sharing this one's vocabulary. Two skills whose names alone disambiguate them do not need it. A bullet that just negates the when_to_use ("do not use for non-[Vendor] questions") is filler — cut it.

Key Concepts

The entities, relationships, and terminology Claude needs before touching the API. Prefer a compact table for enums and status codes. If the full field reference is long, summarize the important fields here and link the complete table:

See references/fields.md for the complete field reference.

Common Workflows

Workflow name

1. Step one
2. Step two

Include decision points and the non-obvious ordering constraints. Skip workflows that are just "call the endpoint."

API Patterns

The request shapes that aren't guessable — auth quirks, pagination casing, filter syntax. Link references/api.md for the exhaustive endpoint catalog if it's long.

Gotchas

The section that earns the skill its tokens: rate-limit behavior, case-sensitive parameters, fields that silently drop, errors whose messages mislead. Each entry: what happens, why, what to do instead.

Related Skills

Only if the links genuinely route the reader somewhere (e.g., a shared auth skill). Omit otherwise.