Skip to main content
An Agent Skill is a folder with a SKILL.md file that a coding agent loads when a task matches its description. Claude Code, Cursor, and other agents that follow the Agent Skills format read the same file. A Flexprice skill does not add a new API; it tells the agent which existing surface to use for which job, and the conventions your team wants followed.

What to connect before writing a skill

Before writing a skill, connect the surfaces it will call:

A minimal Flexprice agent skill

Create .claude/skills/flexprice/SKILL.md in your repository (or the equivalent skills directory for your agent):

Making the skill safe by construction

The skill text is advice. Enforce the important parts with configuration the agent cannot talk itself out of:
  • Scope the MCP server. Start it with --scope read for exploration and add write only for agents that are expected to change data. See MCP server.
  • Use a sandbox key. A key is bound to one environment, so a sandbox key cannot touch production.
  • Use a scoped API key. Create a key with a read-only role for read-heavy agents. See Manage API keys.
  • Require confirmation in the client. Most MCP clients can ask a human before running a write tool. Turn that on.

Extending the skill

Skills grow by adding files next to SKILL.md. Useful additions for Flexprice:
  • references/events.md: the event names and property keys your product emits, so the agent never guesses a meter.
  • references/plans.md: your plan lookup keys and what each entitles.
  • scripts/backfill.sh: a vetted script the agent runs instead of composing bulk ingestion by hand.

CLI output and scripting