{
  "markdown": "# Synadia Insights\n\n- Website - https://www.synadia.com/insights\n- Trial - https://www.synadia.com/insights/trial\n- Docs - https://docs.synadia.com/insights\n- Feedback - insights-report@synadia.com\n\n## Agent Skills\n\nThis repo doubles as a [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces)\ndistributing [Agent Skills](https://code.claude.com/docs/en/skills) for working with Insights.\n\n### Install in Claude Code\n\n```\n/plugin marketplace add synadia-io/insights\n/plugin install insights-skills@synadia-insights\n```\n\nThe `insights-skills` plugin currently bundles:\n\n- **query-insights** — query an Insights database (DuckDB over NATS) with the `insights query` / `insights db`\n  subcommands: schema discovery, epoch scoping, aggregation contexts, and audit-check macros.\n\n### Install in Gemini CLI\n\nThe repo root is also a [Gemini CLI extension](https://geminicli.com/docs/extensions/). Installing it loads\nthe skill content as session context via `GEMINI.md`:\n\n```\ngemini extensions install synadia-io/insights\n```\n\nManage it with `gemini extensions list`, `gemini extensions update insights-skills`, and\n`gemini extensions remove insights-skills`.\n\n### Use elsewhere\n\nThe skill itself is a single [`SKILL.md`](plugins/insights-skills/skills/query-insights/SKILL.md) following the\nopen [Agent Skills](https://agentskills.io/specification) format — it's the source of truth, and every install\npath above points back to it. To use it with a tool that has no one-command installer, copy that skill folder\n(`plugins/insights-skills/skills/query-insights/`) into the tool's skills directory:\n\n| Tool | Where to copy the skill folder |\n| --- | --- |\n| **Claude Code** (personal) | `~/.claude/skills/query-insights/` |\n| **Claude Agent SDK** | a `~/.claude/skills/` or project `.claude/skills/` dir discovered via `setting_sources` |\n| **OpenAI Codex CLI** | `~/.agents/skills/query-insights/` (user) or `.agents/skills/` (project) |\n| **Cursor** | `.cursor/skills/query-insights/` (per project) |\n| **Claude Desktop / claude.ai** | zip the folder and upload under Settings → Capabilities → Skills |\n\n> Note: the install commands for Claude Code and Gemini CLI are verified against current docs. Other tools read\n> the open `SKILL.md` format but each has its own (evolving) discovery path — confirm the exact directory against\n> your tool's docs before relying on it.\n\n",
  "bytes": 2397,
  "sha": "93706558ad1e0509253ffe2a79f0dd58fb21fe423420512d52b809634dbe32c4",
  "repo_slug": "synadia-io/insights",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_synadia_io_insights_d5e1a800/readme"
}