SigNoz Agent Skills

Official SigNoz skills for 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

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.

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
• Cursor plugin root: plugins/signoz
• Repository: SigNoz/agent-skills

Repository Structure

.
├── .claude-plugin/
│   └── marketplace.json
├── .cursor-plugin/
│   └── marketplace.json
├── plugins/
│   ├── signoz/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── .cursor-plugin/
│   │   │   └── plugin.json
│   │   └── 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.

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/.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