Holistics

Holistics 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.

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

Loading

Contributions are welcome — see 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:

/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: 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: Finance and SaaS metrics — lifetime value, unit economics, and similar workflows.
• holistics-development: When you are developing your AMQL project with coding agents such as Claude Code, Codex, etc.
• holistics-reporting: 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: 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/ 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.

• optional: Optional skills that can be imported based on your Holistics organisation's needs.
• built-in: Built-in skills that are already included in the base skillset of Holistics native AI agent.

To import or override: in the Skill creation UI inside Holistics, select skills on the From library tab.

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 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.

License

This repository is licensed under the Apache License 2.0. By contributing, you agree that your contributions will be licensed under the same terms.