metabase-skill 1.0.0__tar.gz

metabase_skill-1.0.0/.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+__pycache__/
+*.pyc
+.venv/
+graph/index.json
+dist/
+build/
+*.egg-info/
+

metabase_skill-1.0.0/CREDITS.md

@@ -0,0 +1,26 @@
+# Credits
+
+## Documentation source
+
+This skill’s knowledge base is built from official Metabase documentation.
+
+- Live handbook: https://www.metabase.com/docs/latest/
+- Source files snapshotted into `source/`: the `docs/` tree of https://github.com/metabase/metabase
+- Snapshot date: 2026-09-10
+- Latest Metabase at snapshot: **63.17** (open source `v0.63.17`, Pro/Enterprise `v1.63.17`) — [release](https://github.com/metabase/metabase/releases/tag/v0.63.17)
+- Documentation copyright: **© Metabase, Inc.** The docs in `source/` are not copyrighted by this skill’s author.
+
+Answers should cite those official URLs. This skill is not affiliated with or endorsed by Metabase, Inc. Non-enterprise paths are licensed AGPL; see [NOTICE.md](NOTICE.md).
+
+## Authorship
+
+| Role | Name |
+|------|------|
+| Author | Ishan Sarkar |
+| Implementation | Cursor AI agent |
+
+Skill packaging (`SKILL.md`, lookup script, concept graph, installer, `references/`) was produced in Cursor.
+
+## License for this packaging
+
+MIT. Copyright © 2026 Ishan Sarkar. See [LICENSE](LICENSE).

metabase_skill-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ishan Sarkar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

metabase_skill-1.0.0/NOTICE.md

@@ -0,0 +1,30 @@
+# Notices
+
+## Credits
+
+See [CREDITS.md](CREDITS.md) for documentation source and authorship.
+
+- **Author:** Ishan Sarkar
+- **Implementation:** Cursor AI agent
+- **Documentation source:** https://www.metabase.com/docs/latest/ and the `docs/` directory of https://github.com/metabase/metabase
+- **Documentation copyright:** © Metabase, Inc.
+- **Docs snapshot:** 2026-09-10, latest Metabase **63.17** (`v0.63.17` / `v1.63.17`)
+
+## This skill packaging (MIT)
+
+`SKILL.md`, `scripts/`, `graph/concepts.json`, `references/`, `install.sh`, `README.md`, `CREDITS.md`, and `src/metabase_skill/` are original packaging for Agent Skills. Copyright © 2026 Ishan Sarkar. Licensed under MIT (see `LICENSE`).
+
+## Metabase documentation snapshot (`source/`)
+
+Files under `source/` are a verbatim snapshot of the `docs/` directory from [metabase/metabase](https://github.com/metabase/metabase). **Copyright © Metabase, Inc.** This skill’s author does not own that copyright.
+
+That tree is licensed under the GNU Affero General Public License v3.0 as described in Metabase's `LICENSE.txt` (non-enterprise paths). See:
+
+https://github.com/metabase/metabase/blob/master/LICENSE.txt
+https://github.com/metabase/metabase/blob/master/LICENSE-AGPL.txt
+
+If `source/` is missing, `scripts/lookup.py` fetches `docs/` from GitHub on first run.
+
+Official live documentation: https://www.metabase.com/docs/latest/
+
+This skill is not affiliated with or endorsed by Metabase, Inc.

metabase_skill-1.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.5
+Name: metabase-skill
+Version: 1.0.0
+Summary: Agent Skill that answers Metabase questions from a local copy of the official docs.
+Project-URL: Homepage, https://github.com/IshanSarkar/metabase-skill
+Project-URL: Repository, https://github.com/IshanSarkar/metabase-skill
+Project-URL: Issues, https://github.com/IshanSarkar/metabase-skill/issues
+Project-URL: Documentation, https://www.metabase.com/docs/latest/
+Author: Ishan Sarkar
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-skill,claude,cursor,metabase
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Documentation
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Metabase skill for any AI agent
+
+An [Agent Skill](https://agentskills.io/specification) that answers Metabase questions from a local copy of the official Metabase docs. Author: Ishan Sarkar. Implementation: Cursor AI agent. Attribution: [CREDITS.md](CREDITS.md).
+
+**OS:** macOS, Linux, Windows. The skill is files + Python stdlib — no Docker, no native binaries.
+
+**Agents:** Cursor, Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, and any client that loads `SKILL.md`.
+
+After install, start a new chat and ask in plain language. You do not need a slash command.
+
+```
+How do I give each customer only their own rows?
+Embed a chart in our React app without making them log into Metabase.
+SQL dropdown that lists product categories.
+```
+
+## Install (pick one)
+
+### pip (no Node.js)
+
+```bash
+pip install "git+https://github.com/IshanSarkar/metabase-skill.git"
+metabase-skill
+```
+
+After the package is on PyPI, that becomes `pip install metabase-skill` then `metabase-skill`. Same flags as the Python installer (`--project`, `--agent cursor`). `python -m metabase_skill` is equivalent.
+
+Windows: `py -m pip install ...` then `metabase-skill` (or `py -m metabase_skill`).
+
+### Clone + Python installer
+
+Needs [Python 3.9+](https://www.python.org/downloads/) and git. Same idea on every OS.
+
+macOS / Linux:
+
+```bash
+git clone https://github.com/IshanSarkar/metabase-skill.git
+cd metabase-skill
+python3 scripts/install.py
+```
+
+Windows (PowerShell or cmd):
+
+```powershell
+git clone https://github.com/IshanSarkar/metabase-skill.git
+cd metabase-skill
+py -3 scripts\install.py
+```
+
+If you already have the folder, skip clone and run the installer from inside it. Flags: `--project` (current repo only), `--agent cursor` (one product). Unix shortcut: `./install.sh` (calls the same Python installer).
+
+No git: download the [ZIP](https://github.com/IshanSarkar/metabase-skill/archive/refs/heads/main.zip), unzip, then run the same `python3` / `py -3` command from that folder.
+
+### Skills CLI (needs Node.js)
+
+Needs [Node.js](https://nodejs.org/). Same command on macOS, Linux, and Windows:
+
+```bash
+npx skills add IshanSarkar/metabase-skill -g -y
+```
+
+Add `-a cursor -a claude-code -a codex` to target specific products.
+
+From a local clone:
+
+```bash
+npx skills add . -g -y
+```
+
+### Cursor only — clone into the skills folder
+
+| OS | Folder |
+|----|--------|
+| macOS / Linux | `~/.cursor/skills/metabase` |
+| Windows | `%USERPROFILE%\.cursor\skills\metabase` |
+
+```bash
+git clone https://github.com/IshanSarkar/metabase-skill.git ~/.cursor/skills/metabase
+```
+
+Windows PowerShell:
+
+```powershell
+git clone https://github.com/IshanSarkar/metabase-skill.git "$env:USERPROFILE\.cursor\skills\metabase"
+```
+
+Then start a **new** Agent chat.
+
+## Requirements
+
+- **Python 3.9+** for lookup (standard library only: `pathlib`, `json`, `re`)
+- Optional: **pip** if you install with `pip install ...` (then run `metabase-skill`)
+- Optional: **git** if `source/` is missing (first lookup clones Metabase `docs/`)
+- Optional: **Node.js** only if you install via `npx skills add`
+
+| OS | Python command |
+|----|----------------|
+| macOS / Linux | `python3` |
+| Windows | `py -3` or `python` |
+
+## How to use it in conversation
+
+1. Install the skill.
+2. Open a **new** agent thread (so the skill is discovered).
+3. Ask a Metabase question in your own words.
+
+The agent should run `scripts/lookup.py`, read the few PRIMARY pages, and answer with official doc links. If it does not, say: `Use the metabase skill` or `/metabase` where your client supports slash skills.
+
+## Layout
+
+```
+SKILL.md                 # router (small — loaded when the skill fires)
+scripts/lookup.py        # run this; do not paste it into context
+scripts/install.py       # cross-platform installer
+graph/concepts.json      # slang → official Metabase concepts
+source/                  # official docs snapshot
+references/              # short topic cheat sheets
+install.sh               # Unix wrapper around scripts/install.py
+```
+
+## Credits
+
+See [CREDITS.md](CREDITS.md).
+
+- **Documentation source:** [Metabase documentation](https://www.metabase.com/docs/latest/) and the `docs/` folder of [metabase/metabase](https://github.com/metabase/metabase)
+- **Documentation copyright:** © Metabase, Inc.
+- **Docs snapshot:** 2026-09-10; latest Metabase at that time: **63.17** (`v0.63.17` OSS, `v1.63.17` Pro/Enterprise)
+- **Author:** Ishan Sarkar
+- **Implementation:** Cursor AI agent
+
+This skill is not affiliated with or endorsed by Metabase, Inc.
+
+## License
+
+Skill packaging: MIT (`LICENSE`), Copyright © 2026 Ishan Sarkar.  
+`source/` is Metabase documentation, copyright © Metabase, Inc. (AGPL); see `NOTICE.md`.

metabase_skill-1.0.0/README.md

@@ -0,0 +1,136 @@
+# Metabase skill for any AI agent
+
+An [Agent Skill](https://agentskills.io/specification) that answers Metabase questions from a local copy of the official Metabase docs. Author: Ishan Sarkar. Implementation: Cursor AI agent. Attribution: [CREDITS.md](CREDITS.md).
+
+**OS:** macOS, Linux, Windows. The skill is files + Python stdlib — no Docker, no native binaries.
+
+**Agents:** Cursor, Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, and any client that loads `SKILL.md`.
+
+After install, start a new chat and ask in plain language. You do not need a slash command.
+
+```
+How do I give each customer only their own rows?
+Embed a chart in our React app without making them log into Metabase.
+SQL dropdown that lists product categories.
+```
+
+## Install (pick one)
+
+### pip (no Node.js)
+
+```bash
+pip install "git+https://github.com/IshanSarkar/metabase-skill.git"
+metabase-skill
+```
+
+After the package is on PyPI, that becomes `pip install metabase-skill` then `metabase-skill`. Same flags as the Python installer (`--project`, `--agent cursor`). `python -m metabase_skill` is equivalent.
+
+Windows: `py -m pip install ...` then `metabase-skill` (or `py -m metabase_skill`).
+
+### Clone + Python installer
+
+Needs [Python 3.9+](https://www.python.org/downloads/) and git. Same idea on every OS.
+
+macOS / Linux:
+
+```bash
+git clone https://github.com/IshanSarkar/metabase-skill.git
+cd metabase-skill
+python3 scripts/install.py
+```
+
+Windows (PowerShell or cmd):
+
+```powershell
+git clone https://github.com/IshanSarkar/metabase-skill.git
+cd metabase-skill
+py -3 scripts\install.py
+```
+
+If you already have the folder, skip clone and run the installer from inside it. Flags: `--project` (current repo only), `--agent cursor` (one product). Unix shortcut: `./install.sh` (calls the same Python installer).
+
+No git: download the [ZIP](https://github.com/IshanSarkar/metabase-skill/archive/refs/heads/main.zip), unzip, then run the same `python3` / `py -3` command from that folder.
+
+### Skills CLI (needs Node.js)
+
+Needs [Node.js](https://nodejs.org/). Same command on macOS, Linux, and Windows:
+
+```bash
+npx skills add IshanSarkar/metabase-skill -g -y
+```
+
+Add `-a cursor -a claude-code -a codex` to target specific products.
+
+From a local clone:
+
+```bash
+npx skills add . -g -y
+```
+
+### Cursor only — clone into the skills folder
+
+| OS | Folder |
+|----|--------|
+| macOS / Linux | `~/.cursor/skills/metabase` |
+| Windows | `%USERPROFILE%\.cursor\skills\metabase` |
+
+```bash
+git clone https://github.com/IshanSarkar/metabase-skill.git ~/.cursor/skills/metabase
+```
+
+Windows PowerShell:
+
+```powershell
+git clone https://github.com/IshanSarkar/metabase-skill.git "$env:USERPROFILE\.cursor\skills\metabase"
+```
+
+Then start a **new** Agent chat.
+
+## Requirements
+
+- **Python 3.9+** for lookup (standard library only: `pathlib`, `json`, `re`)
+- Optional: **pip** if you install with `pip install ...` (then run `metabase-skill`)
+- Optional: **git** if `source/` is missing (first lookup clones Metabase `docs/`)
+- Optional: **Node.js** only if you install via `npx skills add`
+
+| OS | Python command |
+|----|----------------|
+| macOS / Linux | `python3` |
+| Windows | `py -3` or `python` |
+
+## How to use it in conversation
+
+1. Install the skill.
+2. Open a **new** agent thread (so the skill is discovered).
+3. Ask a Metabase question in your own words.
+
+The agent should run `scripts/lookup.py`, read the few PRIMARY pages, and answer with official doc links. If it does not, say: `Use the metabase skill` or `/metabase` where your client supports slash skills.
+
+## Layout
+
+```
+SKILL.md                 # router (small — loaded when the skill fires)
+scripts/lookup.py        # run this; do not paste it into context
+scripts/install.py       # cross-platform installer
+graph/concepts.json      # slang → official Metabase concepts
+source/                  # official docs snapshot
+references/              # short topic cheat sheets
+install.sh               # Unix wrapper around scripts/install.py
+```
+
+## Credits
+
+See [CREDITS.md](CREDITS.md).
+
+- **Documentation source:** [Metabase documentation](https://www.metabase.com/docs/latest/) and the `docs/` folder of [metabase/metabase](https://github.com/metabase/metabase)
+- **Documentation copyright:** © Metabase, Inc.
+- **Docs snapshot:** 2026-09-10; latest Metabase at that time: **63.17** (`v0.63.17` OSS, `v1.63.17` Pro/Enterprise)
+- **Author:** Ishan Sarkar
+- **Implementation:** Cursor AI agent
+
+This skill is not affiliated with or endorsed by Metabase, Inc.
+
+## License
+
+Skill packaging: MIT (`LICENSE`), Copyright © 2026 Ishan Sarkar.  
+`source/` is Metabase documentation, copyright © Metabase, Inc. (AGPL); see `NOTICE.md`.

metabase_skill-1.0.0/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: metabase
+description: >-
+  Answers questions about Metabase using a local knowledge base built from the
+  official docs (install, Docker/JAR, databases, questions, SQL parameters,
+  dashboards, Data Studio, models, metrics, permissions, SSO, embedding SDK,
+  Metabot, API, Cloud). Use whenever the user mentions Metabase, MBQL, Metabot,
+  Metabase embedding, guest/static embeds, row-level security in Metabase, or
+  Metabase Cloud vs self-hosting.
+license: MIT
+compatibility: Requires Python 3.9+ (stdlib only). macOS, Linux, and Windows. Works with any Agent Skills client (Cursor, Claude Code, Codex, Copilot, Gemini CLI, OpenCode, and others).
+metadata:
+  version: "1.0.0"
+  docs_snapshot: "2026-09-10"
+  docs_metabase_version: "63.17"
+  author: Ishan Sarkar
+  implemented_by: Cursor AI agent
+  docs_source: https://www.metabase.com/docs/latest/
+  docs_copyright: Metabase, Inc.
+---
+
+# Metabase Knowledge Base
+
+This skill's root is the directory that contains this `SKILL.md` file.
+Docs referred from: https://www.metabase.com/docs/latest/ (snapshot in `source/`, Metabase 63.17 as of 2026-09-10). Documentation copyright: Metabase, Inc.
+Authorship: [CREDITS.md](CREDITS.md) — Ishan Sarkar; Cursor AI agent.
+
+## Mandatory retrieval (do not skip)
+
+Never answer Metabase questions from this file or from memory.
+
+From **this skill root** (the folder that contains `SKILL.md`), **run** — do not read — the lookup script:
+
+```bash
+python3 scripts/lookup.py "PASTE THE USER QUESTION"
+```
+
+On Windows, if `python3` is missing, use `python` or `py -3`. If the current working directory is not the skill root, invoke `scripts/lookup.py` next to this file.
+
+Then:
+
+1. **Read** every `read_path` listed under PRIMARY (absolute paths printed by lookup).
+2. Do **not** treat ALSO CHECK as required.
+3. If `MISS_RISK: True` or PRIMARY does not mention a noun from the question, search `source/` from the skill root: `rg -i -n 'noun' source -g '*.md'`.
+4. Still missing or version-specific → fetch `https://www.metabase.com/docs/latest/<path>`.
+5. Cite that official URL. Flag OSS vs Pro/Enterprise.
+
+Lookup expands slang (`sandbox` → row-and-column-security) and ranks exact concept pages over the rest of that family.
+
+## Where the facts are
+
+| Path | Role |
+|------|------|
+| `source/` | Complete Metabase docs. Relative path = URL after `/docs/latest/` |
+| `references/` | Optional cheat sheet **after** lookup, never instead of `source/` |
+| `graph/concepts.json` | Alias + intent graph used by lookup |
+| `scripts/lookup.py` | Retrieval. Always **run**, never load into context |
+
+Skip `source/embedding/sdk/api/snippets/` unless the user names an SDK prop.
+
+## Plan gates (do not get wrong)
+
+Row/column security, impersonation, DB routing, JWT/SAML/OIDC, full-app embedding, tenants, serialization: **Pro/Enterprise**. Guest embeds work on OSS. Public links bypass row-level security. Permissions: **most permissive group wins**; restrict **All Users** first.