Agent Skills are an open format for extending AI coding assistants with specialized knowledge and capabilities. Once installed, your agent uses them whenever it detects a relevant task - no prompting required.
When you ask your AI assistant something like "why did this alert fire," "create a dashboard for my Postgres database," or "write a ClickHouse query for these logs," the agent picks the matching skill and follows its instructions.
SigNoz ships these skills two ways:
- The SigNoz plugin - the recommended path. One install bundles every skill plus the MCP server registration, so your agent can both reason about SigNoz and act on your data. Available for Claude Code, Codex, Cursor, Gemini CLI, Devin CLI, and Antigravity CLI.
- Individual skills via skills.sh - install one or more skill files on their own, for any skills.sh-compatible agent.
Install the plugin
-
Add the marketplace and install the plugin:
/plugin marketplace add SigNoz/agent-skills /plugin install signoz@signoz-skills -
When prompted for your SigNoz MCP endpoint:
- SigNoz Cloud - use
https://mcp.<region>.signoz.cloud/mcpand replace<region>with your region (us,us2,eu,eu2,in, orin2). Find your region under Settings → Ingestion in SigNoz, or see the region reference. - Self-hosted SigNoz - enter your own HTTP
/mcpURL instead, for examplehttp://localhost:8000/mcp.
- SigNoz Cloud - use
-
Run
/mcp, select thesignozserver, and complete the authentication flow if prompted.
To change the endpoint later, reconfigure the plugin's options or run signoz-mcp-setup with the new region or MCP URL.
To update after new releases:
/plugin marketplace update
/plugin update signoz@signoz-skills
The plugin ships a PreToolUse hook that auto-allows WebFetch to signoz.io domains. This does not affect Bash-based network calls (curl, wget), which follow the normal permission flow.
Add the marketplace:
codex plugin marketplace add SigNoz/agent-skills
Then, in a Codex session started from your project:
-
Run
/plugins, open the SigNoz marketplace, and installsignoz. -
Point the MCP server at your instance with your SigNoz Cloud region (
us,us2,eu,eu2,in,in2) or a self-hosted HTTP MCP URL:signoz-mcp-setup <region> -
Authenticate over OAuth and verify the connection:
codex mcp login signoz codex mcp list # signoz -> enabled, Auth = logged in
The plugin is not yet on the public Cursor Marketplace, so install it through a Team Marketplace:
- Add
https://github.com/SigNoz/agent-skillsas a team marketplace under Settings → Plugins. - Install the
signozplugin from the marketplace panel. - In an agent chat, run
/signoz-mcp-setupwith your SigNoz Cloud region or self-hosted HTTP MCP URL. - Reload Cursor, then open MCP settings and complete authentication for the
signozserver if prompted.
Install the extension:
gemini extensions install https://github.com/SigNoz/agent-skills
When prompted, enter your SigNoz Cloud region (us, us2, eu, eu2, in, or in2). Then authenticate:
/mcp auth signoz
Follow the prompts to enter your SigNoz instance URL and API key.
-
Install the plugin:
devin plugins install SigNoz/agent-skillsThis installs at user level and works across all projects. Devin's plugin system does not bundle MCP servers or prompt for install-time config, so the next steps set that up.
-
In a Devin session, run the setup skill with your SigNoz Cloud region (
us,us2,eu,eu2,in,in2) or a self-hosted HTTP MCP URL. Devin namespaces plugin skills as/<plugin>:<skill>, so it's invoked as/signoz:signoz-mcp-setup:/signoz:signoz-mcp-setup <region-or-mcp-url>This writes a
signozentry into the highest-precedence Devin config scope that already has one, or~/.config/devin/config.jsonby default. -
Authenticate:
- SigNoz Cloud - start a new session and run
devin mcp login signozto complete OAuth. - Self-hosted SigNoz - no OAuth step is needed unless the server runs with
OAUTH_ENABLED=true.
- SigNoz Cloud - start a new session and run
-
Install the plugin directly from the repository. Antigravity stages the repo root as a native plugin and registers the
signozMCP server and its skills automatically:agy plugin install https://github.com/SigNoz/agent-skills agy plugin list # confirm signoz is loadedReinstall with the same command to update.
-
The plugin defaults to the SigNoz Cloud
usendpoint (https://mcp.us.signoz.cloud/mcp). To point it at a different region or a self-hosted instance, run the setup skill in theagyprompt with your SigNoz Cloud region (us,us2,eu,eu2,in,in2) or a self-hosted HTTP MCP URL (ex:http://localhost:8000/mcp):/signoz:signoz-mcp-setup <region-or-mcp-url>This rewrites
serverUrlin the installedmcp_config.json. SigNoz Cloudususers can skip this step. -
Authenticate. In the
agyprompt, type/mcp, select thesignozserver, and choose Authenticate to start the OAuth flow, then complete it in the browser. Self-hosted endpoints need no OAuth unless the server runs withOAUTH_ENABLED=true.
Install individual skills
If you want only specific skills, or you use an agent without plugin support, install skill files directly with skills.sh. This works for any compatible agent (Codex, Cursor, Gemini, OpenCode, and more).
Install all SigNoz skills:
npx skills add SigNoz/agent-skills
Install a specific skill:
npx skills add SigNoz/agent-skills --skill signoz-searching-docs
npx skills add SigNoz/agent-skills --skill signoz-writing-clickhouse-queries
skills.sh installs the skill files only, not the bundled MCP registration. Skills that act on your data (queries, dashboards, alerts, views) need the SigNoz MCP Server connected separately.
Available Skills
The plugin ships the skills below. Your agent selects the right one automatically when it detects a matching task. Click any name to read its source SKILL.md.
Setup and docs
- signoz-mcp-setup - Initialize or repair the SigNoz MCP server configuration for Claude Code, Codex, Cursor, VS Code/GitHub Copilot, Claude Desktop, Gemini CLI, Windsurf, Zed, Antigravity, OpenCode, or another MCP client.
- signoz-searching-docs - SigNoz docs guidance for instrumentation, setup, querying, alerts, and APIs.
Querying your data
- signoz-generating-queries - Generate queries against SigNoz observability data (traces, logs, metrics).
- signoz-writing-clickhouse-queries - Optimized ClickHouse queries for SigNoz OpenTelemetry traces and logs.
Dashboards
- signoz-creating-dashboards - Create a new SigNoz dashboard from a natural-language intent - import a curated template (PostgreSQL, Redis, JVM, k8s, APM, LLM, etc.) when one fits, or build a custom dashboard with metric, trace, and log panels.
- signoz-modifying-dashboards - Modify an existing SigNoz dashboard: add, remove, or edit panels, variables, queries, and layout.
- signoz-explaining-dashboards - Explain panels, queries, and layout of an existing SigNoz dashboard.
Alerts
- signoz-creating-alerts - Create SigNoz alert rules for threshold breaches, error rates, latency, anomaly detection, and absent-data conditions across metrics, logs, and traces.
- signoz-explaining-alerts - Explain and interpret an existing SigNoz alert rule's configuration, evaluation behavior, notification routing, and recent fire frequency.
- signoz-investigating-alerts - Diagnose why a SigNoz alert fired by correlating its signal with neighbor metrics, traces, and logs around the fire window, and ranking likely causes.
Views and workflows
- signoz-managing-views - Create, list, inspect, update, or delete SigNoz saved Explorer views (logs, traces, metrics) via the SigNoz MCP server.
- signoz-setting-up-observability - Orchestrate the full post-ingestion observability setup for a service - SLI/SLO capture, RED/USE exploration, focused dashboards, saved views, burn-rate and absent-data alerts, and a tuning loop - sequencing the single-artifact skills into one SLO-aware workflow.
Learn more
- SigNoz skills on skills.sh - browse available skills and install instructions.
- GitHub repository - plugin source, skill structure, and per-client setup recipes.
- SigNoz MCP Server - connect and authenticate the MCP server the skills act through.
- AI Use Cases - real-world workflows you can run once everything is wired up.
