SigNoz Agent Skills

Official SigNoz skills for Codex, Claude Code, Cursor, and the skills.sh ecosystem.

Available Skills

Skill	Description
signoz-clickhouse-query	Write optimized ClickHouse queries for SigNoz OpenTelemetry data to build dashboard panels from traces and logs.
signoz-docs	Use official SigNoz docs to answer instrumentation, setup, querying, troubleshooting, deployment, and API questions.

Installation

Claude Code

/plugin marketplace add SigNoz/agent-skills
/plugin install signoz@signoz-skills

To update after new releases:

/plugin marketplace update
/plugin update signoz@signoz-skills

The Claude plugin ships a PreToolUse hook that auto-allows WebFetch requests to https://signoz.io/... and https://*.signoz.io/.... This does not affect network calls made through Bash, such as curl or wget, which still follow Claude Code's normal permission flow.

Cursor Plugin

This repository includes a Cursor marketplace manifest at .cursor-plugin/marketplace.json and a Cursor plugin manifest at plugins/signoz/.cursor-plugin/plugin.json.

This plugin is not yet published on the public Cursor Marketplace. Install it manually through a Cursor Team Marketplace:

1. Add https://github.com/SigNoz/agent-skills as a Cursor team marketplace.
2. In the Cursor dashboard, go to Settings -> Plugins.
3. Under Team Marketplaces, click Import.
4. Paste the GitHub repository URL and save the marketplace.
5. Open the marketplace panel in Cursor and install the signoz plugin.

Codex Plugin

This repository now includes a Codex repo marketplace at .agents/plugins/marketplace.json and a Codex plugin manifest at plugins/signoz/.codex-plugin/plugin.json.

To use it from this repository:

1. Open the repository in Codex.
2. Restart Codex if it was already running.
3. Open the plugin surface with /plugins.
4. Install the signoz plugin from the SigNoz marketplace.

To distribute it outside this repository, copy plugins/signoz into the target repo's plugins/ directory and copy the marketplace entry format from .agents/plugins/marketplace.json into that repo's $REPO_ROOT/.agents/plugins/marketplace.json.

skills.sh

Install all SigNoz skills:

npx skills add SigNoz/agent-skills

Install a specific skill:

npx skills add SigNoz/agent-skills --skill signoz-docs
npx skills add SigNoz/agent-skills --skill signoz-clickhouse-query

IDs

• Marketplace id: signoz-skills
• Plugin id: signoz
• Codex marketplace path: .agents/plugins/marketplace.json
• Codex plugin root: plugins/signoz
• Cursor plugin root: plugins/signoz
• Repository: SigNoz/agent-skills

Repository Structure

.
├── .agents/
│   └── plugins/
│       └── marketplace.json
├── .claude-plugin/
│   └── marketplace.json
├── .cursor-plugin/
│   └── marketplace.json
├── plugins/
│   ├── signoz/
│   │   ├── .codex-plugin/
│   │   │   └── plugin.json
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── .cursor-plugin/
│   │   │   └── plugin.json
│   │   ├── hooks/
│   │   │   ├── hooks.json
│   │   │   └── scripts/
│   │   │       └── allow-signoz-webfetch.js
│   │   └── skills/
│   │       ├── signoz-clickhouse-query/
│   │       └── signoz-docs/
└── README.md

Creating New Skills

Skills in this repository should follow the Agent Skills specification and live under plugins/signoz/skills/<skill-name>/SKILL.md.

For Codex distribution, keep the repo marketplace at .agents/plugins/marketplace.json pointing to the plugin directory and keep the plugin manifest at plugins/signoz/.codex-plugin/plugin.json in sync with shipped skills.

Use Anthropic's skill-creator as the default workflow for creating or evolving a skill. It helps draft the skill, refine trigger descriptions, and iterate with realistic evaluations.

Install it with:

npx skills add https://github.com/anthropics/skills --skill skill-creator

For a new SigNoz skill:

plugins/signoz/skills/my-skill/
└── SKILL.md

Keep these conventions:

• name in frontmatter must exactly match the directory name.
• description should explain both what the skill does and when it should trigger.
• Keep SKILL.md concise and move deeper reference material into references/, scripts/, or assets/ when needed.
• Bump plugins/signoz/.codex-plugin/plugin.json whenever the Codex plugin ships updated skill content.
• Bump plugins/signoz/.claude-plugin/plugin.json whenever a skill or other plugin-shipped content changes so Claude Code users receive updates.
• Bump plugins/signoz/.cursor-plugin/plugin.json whenever the Cursor plugin ships updated skill content.

License

MIT. See LICENSE.

Example Usage