> ## Documentation Index
> Fetch the complete documentation index at: https://docs.costory.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Costory skills for AI assistants

> Open-source skills that teach Claude, Cursor, Codex and other agents how to run FinOps workflows on the Costory MCP, and how to install them.

Skills are markdown files that teach an AI assistant how to run a FinOps workflow on top of the [Costory MCP](https://docs.costory.io/features/mcp.md) tools: which tool to call first, in what order, and what to check before a write. Each skill covers one class of question, so the assistant does not have to rediscover the sequence every time.

The skills are open source (Apache-2.0) in [costory-io/costory-finops-mcp-skills](https://github.com/costory-io/costory-finops-mcp-skills). The hosted MCP serves the same files through `get_skill`, using the skill ID in the table below.

## Skills in the repository

| Skill ID | Use it when |
| - | - |
| [`query`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/query/SKILL.md) | You explore cost, usage, metric, formula, budget or external-metric data and compare periods in Explorer. |
| [`cost-change-investigation`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/cost-change-investigation/SKILL.md) | You explain a cost change with contribution, timing, usage, metric, event, alert and terminology evidence. |
| [`virtual-dimensions`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/virtual-dimensions/SKILL.md) | You create, edit, preview and publish custom cost axes with ordered CEL rules. |
| [`dashboards`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/dashboards/SKILL.md) | You create or extend dashboards, with widgets that inherit the dashboard period, group-by and filters. |
| [`reports`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/reports/SKILL.md) | You schedule Slack, Teams or email reports, or explain last month's cost with a Digest preview. |
| [`bigquery`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/bigquery/SKILL.md) | You investigate BigQuery cost drivers (on-demand vs slots, physical vs logical storage, labels) or open the BigQuery dashboard template. |
| [`recipes`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/plugins/costory/skills/recipes/SKILL.md) | You state an outcome instead of a tool. The skill picks a ready-made tracking design, then hands off to the skills above to build it. |

The [`recipes` library](https://github.com/costory-io/costory-finops-mcp-skills/tree/main/plugins/costory/skills/recipes) covers BigQuery warehouse routing, Google Cloud spend-based CUDs, budget vs actual dashboards, EC2 spike alerts, prod vs R\&D splits, untagged coverage, marketplace spend, provider credits, Kubernetes namespace cost, compute drill-downs and period-change explanations.

For Kiro, the repository also ships [`costory-finops`](https://github.com/costory-io/costory-finops-mcp-skills/blob/main/powers/costory/skills/costory-finops/SKILL.md), a condensed skill that covers organization selection, tool order and preview-then-confirm for write tools, and loads the detailed skills with `get_skill`.

## Install the skills

> [tab] Claude Code
>
> The plugin connects the MCP and installs the skills in one step.
>
> ```bash theme={null}
> claude plugin marketplace add costory-io/costory-finops-mcp-skills
> claude plugin install costory@costory
> ```

> [tab] Codex
>
> ```bash theme={null}
> codex plugin marketplace add costory-io/costory-finops-mcp-skills
> codex plugin add costory@costory
> ```

> [tab] Any agent (skills.sh)
>
> Installs the skills into Claude Code, Cursor, Codex and other agents that read Agent Skills. Connect the MCP separately, see [Costory MCP](https://docs.costory.io/features/mcp.md).
>
> ```bash theme={null}
> npx skills add costory-io/costory-finops-mcp-skills
> ```

> [tab] Kiro
>
> In Kiro, open the **Powers** panel, select **Add Custom Power**, then **Import power from GitHub**, and enter:
>
> ```text theme={null}
> https://github.com/costory-io/costory-finops-mcp-skills/tree/main/powers/costory
> ```

Every skill needs a Costory workspace and the hosted MCP at `https://app-api.costory.io/mcp`. See [Costory MCP](https://docs.costory.io/features/mcp.md) for each client.

## Related

> [card] [Costory MCP](https://docs.costory.io/features/mcp.md)
>
> Connect Claude, Claude Code, Cursor, VS Code or Dust

> [card] [Skills repository](https://github.com/costory-io/costory-finops-mcp-skills)
>
> Source, plugin packaging and authoring guide


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.