- Website - https://www.synadia.com/insights
- Trial - https://www.synadia.com/insights/trial
- Docs - https://docs.synadia.com/insights
- Feedback - insights-report@synadia.com
This repo doubles as a Claude Code plugin marketplace distributing Agent Skills for working with Insights.
/plugin marketplace add synadia-io/insights
/plugin install insights-skills@synadia-insights
The insights-skills plugin currently bundles:
- query-insights — query an Insights database (DuckDB over NATS) with the
insights query/insights dbsubcommands: schema discovery, epoch scoping, aggregation contexts, and audit-check macros.
The repo root is also a Gemini CLI extension. Installing it loads
the skill content as session context via GEMINI.md:
gemini extensions install synadia-io/insights
Manage it with gemini extensions list, gemini extensions update insights-skills, and
gemini extensions remove insights-skills.
The skill itself is a single SKILL.md following the
open Agent Skills format — it's the source of truth, and every install
path above points back to it. To use it with a tool that has no one-command installer, copy that skill folder
(plugins/insights-skills/skills/query-insights/) into the tool's skills directory:
| Tool | Where to copy the skill folder |
|---|---|
| Claude Code (personal) | ~/.claude/skills/query-insights/ |
| Claude Agent SDK | a ~/.claude/skills/ or project .claude/skills/ dir discovered via setting_sources |
| OpenAI Codex CLI | ~/.agents/skills/query-insights/ (user) or .agents/skills/ (project) |
| Cursor | .cursor/skills/query-insights/ (per project) |
| Claude Desktop / claude.ai | zip the folder and upload under Settings → Capabilities → Skills |
Note: the install commands for Claude Code and Gemini CLI are verified against current docs. Other tools read the open
SKILL.mdformat but each has its own (evolving) discovery path — confirm the exact directory against your tool's docs before relying on it.