Agent skill

Signoz

by qjoly in qjoly/GitOps

Manage the self-hosted SigNoz observability stack in this GitOps repo.

WTFPLAuto-check passedDevOps & Cloud

Install Signoz

skills CLI
$ npx skills add qjoly/GitOps --skill signoz -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install qjoly/GitOps signoz --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/qjoly/GitOps.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/signoz .claude/skills/signoz && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
signoz
GitHub stars
112
Token cost
~6.1k tokens
SKILL.md length
2,737 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
WTFPL

At a glance

Manage the self-hosted SigNoz observability stack in this GitOps repo.

  • Works in 3 steps: The metrics must carry the… → Add a DYNAMIC variable. Its id and key… → Add the filter to each query's…
  • Editing SigNoz dashboards
  • SKILL.md covers The dashboard variable filter…, Cluster selector on a dashboard, Cluster selector pitfalls… and Getting application metrics…, plus 11 more sections
  • Calls kubectl and helm; reaches signoz-ingest.mocha.thoughtless.eu

What it does

Signoz is an agent skill from qjoly/GitOps. Manage the self-hosted SigNoz observability stack in this GitOps repo. Use when creating or editing SigNoz dashboards, wiring application metrics into SigNoz (Traefik, ArgoCD, other Prometheus/OTLP sources), configuring alerting and notification channels (Discord), or debugging why a dashboard variable filter does not work. Covers the non-obvious formats SigNoz v0.13x expects.

Its SKILL.md is about 6.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Container orchestration, Monitoring and alerting and GitOps. It works with Argo CD, Kubernetes, Prometheus and OpenTelemetry. The repository describes itself as: Homelab setup based on Omni and Talos.

When your agent uses it

  • Editing SigNoz dashboards
  • Wiring application metrics into SigNoz (Traefik
  • Other Prometheus/OTLP sources)
  • Configuring alerting and notification channels (Discord)

Example prompts

  • “/signoz”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. The metrics must carry the k8s.cluster.name resource attribute (see next section).
  2. Add a DYNAMIC variable. Its id and key MUST be a valid UUID. A made-up non-UUID id
  3. Add the filter to each query's filter.expression

What it can do on your machine

Read from SKILL.md and the folder at commit 254786f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • kubectl
    • helm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • signoz-ingest.mocha.thoughtless.eu

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Signoz loads about 6.1k tokens when it runs. Until then it costs about 97 tokens; SKILL.md has 2,737 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~97
When it runs · the whole SKILL.md, loaded when a task matches
~6.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (WTFPL) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,737 words (~6,119 tokens).

“SigNoz runs on the mocha cluster (mocha/system/signoz/), deployed by the signoz Helm chart via ArgoCD. Other clusters ship telemetry to it over OTLP. Every source is tagged with k8s.cluster.name so data can be told apart.”

— opening of SKILL.md by qjoly, WTFPL
name
signoz

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/signoz of qjoly/GitOps.

Open the folder on GitHubat commit 254786f

Compare with similar skills

Signoz next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Signoz compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Signoz this skillqjoly/GitOps112—~6.1kAutomated safety check: PassWTFPL
Alloygrafana/skills282—~1.3kAutomated safety check: PassApache-2.0
Beylagrafana/skills282—~1.1kAutomated safety check: PassApache-2.0
Mimirgrafana/skills282—~1.2kAutomated safety check: PassApache-2.0
Kubernetes SpecialistJeffallan/claude-skills12k1 repos~2.1kAutomated safety check: PassMIT
Kubernetes ArchitectCybereason-Public/owLSM2809 repos~2.6kAutomated safety check: PassGPL-2.0

Similar skills

  • Alloy

    grafana/skills

    Official

    Build a unified telemetry pipeline with Grafana Alloy — one OpenTelemetry-compatible binary that collects metrics, logs, traces, and profiles and ships to Grafana Cloud / Prometheus / Loki / Tempo /…

    282 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Beyla

    grafana/skills

    Official

    Auto-instrument an application's HTTP / gRPC / DB traffic with Grafana Beyla eBPF — no code changes, no SDK, no restart.

    282 GitHub stars~1.1k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Mimir

    grafana/skills

    Official

    Stand up Grafana Mimir for horizontally scalable, multi-tenant, long-term Prometheus + OTLP metrics storage.

    282 GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Kubernetes Specialist

    Jeffallan/claude-skills

    Creates and checks Kubernetes manifests, Helm charts, RBAC and network policies, and helps debug pod problems, with kubectl checks and rollback steps.

    12k GitHub starsUsed in 1 repo~2.1k tokens
    DevOps & CloudAuto-check passed
  • Kubernetes Architect

    Cybereason-Public/owLSM

    Expert Kubernetes architect specializing in cloud-native infrastructure, advanced GitOps workflows (ArgoCD/Flux), and enterprise container orchestration.

    280 GitHub starsUsed in 9 repos~2.6k tokens
    DevOps & CloudAuto-check passed
  • Sets up GitOps continuous delivery for Kubernetes with ArgoCD or Flux, covering installation, repository layout, sync policies, progressive delivery and secrets.

    40k GitHub starsUsed in 12 repos~1.5k tokens
    DevOps & CloudAuto-check passed

Categories

Questions about Signoz

What does Signoz do?

Manage the self-hosted SigNoz observability stack in this GitOps repo. Signoz is an agent skill from qjoly/GitOps. Manage the self-hosted SigNoz observability stack in this GitOps repo.

When should I use Signoz?

Signoz fits situations like: editing SigNoz dashboards; wiring application metrics into SigNoz (Traefik; other Prometheus/OTLP sources); configuring alerting and notification channels (Discord).

How do I install Signoz in Claude Code?

Run `npx skills add qjoly/GitOps --skill signoz -a claude-code`. Or copy the skill folder (.claude/skills/signoz in qjoly/GitOps) into .claude/skills/signoz in your project. Claude Code loads it when a task matches its description.

How do I install Signoz in Codex?

Run `npx skills add qjoly/GitOps --skill signoz -a codex`. Or copy the skill folder (.claude/skills/signoz in qjoly/GitOps) into .agents/skills/signoz in your project. Codex loads it when a task matches its description.

Can I use Signoz in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add qjoly/GitOps --skill signoz -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/signoz, .gemini/skills/signoz, .github/skills/signoz and .opencode/skills/signoz in your project.

What does Signoz need to run?

Going by SKILL.md and its folder, Signoz needs the command-line tools its instructions call (kubectl and helm).

Does Signoz access the network?

SKILL.md names 1 domain. In commands or code: signoz-ingest.mocha.thoughtless.eu; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Signoz safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Signoz use?

Signoz is published under the WTFPL licence (the repository's licence).

How many tokens does Signoz use?

About 6.1k tokens (SKILL.md is roughly 24k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Signoz?

Skills that share tags, products or a category with Signoz: Alloy (grafana/skills, 282 stars), Beyla (grafana/skills, 282 stars), Mimir (grafana/skills, 282 stars) and Kubernetes Specialist (Jeffallan/claude-skills, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Signoz?

qjoly (a GitHub user) maintains it in qjoly/GitOps, which has 112 GitHub stars. The repository was last updated on October 9, 2026.

Source: qjoly/GitOps on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.