holistics-development — плагин для Claude Code: функции и установка

# Holistics
[Holistics](https://holistics.io) is a modern BI platform that aims to enable self-service data access for entire organization by leveraging analytics-as-code and AI.

# Vision
This is a shared, open repository for analytics skills — both generic and Holistics-specific — designed to grow with the community:

* **A commons for analytics skills.** Data analysts and engineers can contribute and reuse common analytics skills. We expect these to evolve over time into rich, business-domain-specific analytics knowledge and skills that any team can build on.
* **A space for Holistics users to share with each other.** Skills, references, and workflows that work well for one Holistics team can be packaged and shared with the rest of the community.
* **A window to optimize Holistics' native AI agent.** Holistics users can read and import skills for their Holistics native AI agent.

```mermaid
flowchart LR
    subgraph plugins[" "]
        direction TB
        A[<b>Analytics skills</b><br/><i>plugins/analytics*</i>]
        H[<b>Holistics skills</b><br/><i>plugins/holistics-*</i>]
        U1([Generic analytics tasks<br/>For any humans & AI agents])
        P1(( + ))
        U2([Your own AI agents with Holistics access<br/>- Claude Code, Claude.ai, ChatGPT, etc.])

        A ---> U1
        A --- P1
        H --- P1
        P1 --> U2
    end

    subgraph native[" "]
        direction TB
        N[<b>Holistics native skills</b><br/><i>native-skills/</i>]
        U3([Holistics native AI agent])
        N --> U3
    end

    A -. Share skills for .-> N
    H -. Share some skills for .-> N

    style plugins fill:none,stroke:none
    style native fill:none,stroke:none

    classDef base fill:#eef,stroke:#557
    classDef holistics fill:#fde,stroke:#857
    classDef ext fill:#ffe,stroke:#995
    classDef use fill:#efe,stroke:#595,stroke-dasharray:3 3
    classDef plus fill:#fff,stroke:#999,color:#666,font-weight:bold
    class A base
    class H holistics
    class N ext
    class U1,U2,U3 use
    class P1 plus
```

Contributions are welcome — see [Contributions are welcomed](#contributions-are-welcomed) below.

# How to install

## For your own AI agent
Skills under `plugins/` (Holistics-specific skills and generic analytics skills) can be used by any AI coding or chat agent — Claude Code, Claude.ai, ChatGPT, Codex, and others.

The easiest install path is the Claude Code plugin marketplace (shown below). For other agents, you can import or copy the skill files directly from this repo.

### Claude Code
Within Claude Code, run this command to add the Holistics skills marketplace:
```bash
/plugin marketplace add holistics/skills
```

Then browse and install the relevant plugins via `/plugin` > `Marketplaces` > `holistics-skills` > `Browse plugins` > Install.

(Optional) enable auto-update via `/plugin` > `Marketplaces` > `holistics-skills` > `Enable auto-update`.

### Cursor
Cursor's plugin marketplaces are managed at the team/org level (Teams or Enterprise plans). An admin imports the marketplace once, then teammates install individual plugins.

1. As an admin, go to **Dashboard** → **Settings** → **Plugins**.
2. Under **Team Marketplaces**, click **Import** and paste `https://github.com/holistics/skills`.
3. Review the parsed plugins, set Team Access groups if needed, name the marketplace, and save.
4. Teammates open the marketplace panel in Cursor and install the plugins they want (required plugins install automatically).

### Picking a plugin
Browse the linked `skills/` folders to see the actual skill files for each plugin.

* [`analytics`](./plugins/analytics/skills/): Generic analytics workflows (data exploration, analysis, reporting) that aren't tied to Holistics. Use it on its own, or alongside the plugins below.
* [`analytics-finance`](./plugins/analytics-finance/skills/): Finance and SaaS metrics — lifetime value, unit economics, and similar workflows.
* [`holistics-development`](./plugins/holistics-development/skills/): When you are developing your AMQL project with coding agents such as Claude Code, Codex, etc.
* [`holistics-reporting`](./plugins/holistics-reporting/skills/): When you want to ask data questions on published AMQL objects (datasets, dashboards, etc.) with general agents such as Claude.ai, ChatGPT, etc.
* [`holistics-migrate-power-bi`](./plugins/holistics-migrate-power-bi/skills/): When you are migrating a Power BI semantic model (TMDL + DAX) and reports to a Holistics AMQL project. Pair with `holistics-development` for AML/AQL authoring.

## For Holistics native agent
Skills under [`native-skills/`](./native-skills/) can be used by Holistics App to extend **Holistics native AI agent**. They run inside Holistics and have access to native web UI and backend features. Browse the folder to see what's available.

| Native skill type | Path | Availability | Customizable |
| --- | --- | --- | --- |
| System | [`native-skills/system/`](./native-skills/system/) | 📦 Always available | 🔒 No |
| Default | [`native-skills/default/`](./native-skills/default/) | 📦 Available by default | ✏️ Yes |
| Template | [`native-skills/template/`](./native-skills/template/) | 📥 Import on demand | ✏️ Yes |

# Contributions are welcomed
We welcome contributions of new skills, improvements to existing ones, and bug fixes — for the generic Analytics plugins, the Holistics-specific plugins, and the native skills used by Holistics' built-in AI agent.

To get started, see [DEVELOPMENT.md](./DEVELOPMENT.md) for the repository structure and tooling. Then open a pull request against `main` with your changes; for new skills, drop them under the appropriate `plugins/<plugin-name>/skills/` directory (or `native-skills/` for the Holistics native AI agent).

For bug reports or ideas, please [open an issue](https://github.com/holistics/skills/issues).

## Contributors
Thanks to everyone who has contributed to this repository:

<a href="https://github.com/holistics/skills/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=holistics/skills" alt="Contributors" />
</a>

# License
This repository is licensed under the [Apache License 2.0](./LICENSE). By contributing, you agree that your contributions will be licensed under the same terms.