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.

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.

For Holistics native agent

Skills under native-skills/ can be imported into the Holistics App to extend its built-in AI agent. They run inside Holistics and have access to native web UI and backend features. Browse the folder to see what's available.

To install: in the Skill creation UI inside Holistics, choose to import from the Holistics native skill library.

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.