Agent skill

Prometheus Top Resource Consumers

by prometheus in prometheus/prometheus-mcp

“Find the top CPU, memory, or disk consumers. Use for capacity reviews, noisy-neighbor hunts, and top-N questions about which jobs, pods, or instances use the most resources or…”

— description from SKILL.md by prometheus
Apache-2.0Auto-check passedDevOps & Cloud

Install Prometheus Top Resource Consumers

skills CLI
$ npx skills add prometheus/prometheus-mcp --skill find-top-resource-consumers -a claude-code

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

GitHub CLI
$ gh skill install prometheus/prometheus-mcp find-top-resource-consumers --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/prometheus/prometheus-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pkg/mcp/assets/skills/find-top-resource-consumers .claude/skills/find-top-resource-consumers && 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
find-top-resource-consumers
GitHub stars
120
Token cost
~569 tokens
SKILL.md length
241 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • SKILL.md covers Getting oriented, Topics worth exploring and Reporting findings
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

“Find the top CPU, memory, or disk consumers. Use for capacity reviews, noisy-neighbor hunts, and top-N questions about which jobs, pods, or instances use the most resources or drive TSDB growth; builds topk() queries over discovered metrics.”

— description from SKILL.md by prometheus

Prometheus Top Resource Consumers is a skill in prometheus/prometheus-mcp (120 stars). Its SKILL.md is about 569 tokens. Licence: Apache-2.0.

Requirements

  • Compatibility (from SKILL.md): Requires the tools of a connected Prometheus MCP server

What it can do on your machine

Read from SKILL.md and the folder at commit 856fb45. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    Requires the tools of a connected Prometheus MCP server

    From compatibility in the SKILL.md frontmatter.

Context cost

Prometheus Top Resource Consumers loads about 569 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 241 words of instructions outside code blocks.

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

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

The full file from prometheus/prometheus-mcp at commit 856fb45, republished under its Apache-2.0 licence (© prometheus). 241 words, ~569 tokens.

Download SKILL.mdSave it as .claude/skills/find-top-resource-consumers/SKILL.md (or your agent's skills folder).
name
find-top-resource-consumers
description
Find the top CPU, memory, or disk consumers. Use for capacity reviews, noisy-neighbor hunts, and top-N questions about which jobs, pods, or instances use the most resources or drive TSDB growth; builds topk() queries over discovered metrics.
compatibility
Requires the tools of a connected Prometheus MCP server
license
Apache-2.0

Finding Top Resource Consumers

Identify which services, pods, or instances consume the most CPU, memory, or disk -- or drive the most TSDB growth. Resource metrics vary by environment (node_exporter, cadvisor, kubelet, ...), so discover what exists before querying.

Getting oriented

  • label_values on name (or series with regex matchers) reveals which resource metrics exist: node_cpu_seconds_total, container_memory_working_set_bytes, process_resident_memory_bytes, and so on.
  • metric_metadata confirms the type and meaning of whatever discovery turns up.
  • tsdb_stats answers the "who produces the most metrics" version of the question via seriesCountByMetricName.
  • Prometheus's own metrics exposes monitoring cost per target: query topk(10, scrape_samples_scraped) to find the heaviest targets, and a persistently high scrape_series_added means a target keeps minting new series.

Topics worth exploring

Treat these as starting points, adapting metric names to what discovery found:

  • Top CPU: CPU counters need rate() before ranking, e.g. with query: topk(10, sum by (pod) (rate(container_cpu_usage_seconds_total[5m])))
  • Top memory: gauges rank directly: topk(10, sum by (instance) (container_memory_working_set_bytes))
  • Top disk: node_filesystem_avail_bytes vs node_filesystem_size_bytes for fullness; rate(node_disk_written_bytes_total[5m]) for write churn.
  • Trend vs snapshot: range_query the same expressions to see whether a top consumer is growing, cyclic, or stable; a stable hog and a leak need different responses.
  • TSDB growth: the top metric and label names from tsdb_stats show what is inflating storage, often more actionable than any single consumer.

Reporting findings

Rank the top consumers with numbers and units, note whether each is growing or stable, and flag anything disproportionate to its peers as a candidate for follow-up.

© prometheus, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in pkg/mcp/assets/skills/find-top-resource-consumers of prometheus/prometheus-mcp.

Open the folder on GitHubat commit 856fb45

Compare with similar skills

Prometheus Top Resource Consumers 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.

Prometheus Top Resource Consumers compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Prometheus Top Resource Consumers this skillprometheus/prometheus-mcp120—~569Automated safety check: PassApache-2.0
Exploring Apm TracesPostHog/posthog40k—~3.5kAutomated safety check: PassCustom licence
AWS Cost Operationszxkane/aws-skills367—~2.4kAutomated safety check: PassMIT
Archestra Dev Observabilityarchestra-ai/archestra4.4k—~1.2kAutomated safety check: PassCustom licence
Frontmcp Observabilityagentfront/frontmcp146—~4.6kAutomated safety check: PassApache-2.0
AWS Cost OperationsMicrock/ordinary-claude-skills4041 repos~2.5kAutomated safety check: PassCustom licence

Similar skills

  • Exploring Apm Traces

    PostHog/posthog

    Official

    Investigates distributed application performance using PostHog APM (OpenTelemetry span) data via MCP.

    40k GitHub stars~3.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • AWS Cost Operations

    zxkane/aws-skills

    AWS cost optimization, monitoring, and operational excellence expert.

    367 GitHub stars~2.4k tokensUpdated 3 mo ago
    DevOps & CloudAuto-check passed
  • Archestra Dev Observability

    archestra-ai/archestra

    A skill your agent uses when changing Archestra tracing, metrics, OpenTelemetry, Tempo, Grafana, Prometheus, LLM/MCP spans, observability labels, or local observability setup.

    4.4k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Frontmcp Observability

    agentfront/frontmcp

    A skill your agent uses when adding tracing, structured logging, metrics, or monitoring to a FrontMCP server.

    146 GitHub stars~4.6k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • AWS Cost Operations

    Microck/ordinary-claude-skills

    This skill provides AWS cost optimization, monitoring, and operational best practices with integrated MCP servers for billing analysis, cost estimation, observability, and security assessment.

    404 GitHub starsUsed in 1 repo~2.5k tokens
    DevOps & CloudAuto-check passed
  • Neon

    smontlouis/bible-strong

    Overview of Neon, a complete set of cloud backend primitives for apps and agents, spanning Lakebase Postgres, Auth, the Data API, Object Storage, Compute Functions, and the AI Gateway.

    171 GitHub stars~7.1k tokensUpdated today
    Backend & APIsAuto-check: notes

More from prometheus/prometheus-mcp

  • Prometheus System Health Check

    prometheus/prometheus-mcp

    Builds a picture of whether Prometheus itself is healthy and successfully monitoring its targets, covering readiness, firing alerts, target health and TSDB load.

    120 GitHub stars~584 tokensUpdated 5 days ago
    Auto-check passed
  • Prometheus Error Rate Investigator

    prometheus/prometheus-mcp

    Quantifies elevated error rates with PromQL, compares them to a baseline, and isolates which jobs or instances an error spike is concentrated in.

    120 GitHub stars~592 tokensUpdated 5 days ago
    Auto-check passed
  • Prometheus Cardinality Optimizer

    prometheus/prometheus-mcp

    Finds the metrics and labels behind a Prometheus series explosion using a connected Prometheus MCP server, then proposes relabeling, dropping or recording-rule fixes with measured impact.

    120 GitHub stars~547 tokensUpdated 5 days ago
    Auto-check passed
  • Prometheus Rules Review

    prometheus/prometheus-mcp

    Audits Prometheus recording and alerting rules through a connected Prometheus MCP server, finds gaps and noisy alerts, and drafts improved rule-group YAML.

    120 GitHub stars~765 tokensUpdated 5 days ago
    Auto-check passed
  • Finds where a Prometheus metric stops existing, whether at the target, the scrape, relabeling or the query, using the tools of a connected Prometheus MCP server.

    120 GitHub stars~587 tokensUpdated 5 days ago
    Auto-check passed
  • Tune Prometheus Config

    prometheus/prometheus-mcp

    Review and tune Prometheus configuration and performance. An agent skill from prometheus/prometheus-mcp.

    120 GitHub stars~724 tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Prometheus Top Resource Consumers

How do I install Prometheus Top Resource Consumers in Claude Code?

Run `npx skills add prometheus/prometheus-mcp --skill find-top-resource-consumers -a claude-code`. Or copy the skill folder (pkg/mcp/assets/skills/find-top-resource-consumers in prometheus/prometheus-mcp) into .claude/skills/find-top-resource-consumers in your project. Claude Code loads it when a task matches its description.

How do I install Prometheus Top Resource Consumers in Codex?

Run `npx skills add prometheus/prometheus-mcp --skill find-top-resource-consumers -a codex`. Or copy the skill folder (pkg/mcp/assets/skills/find-top-resource-consumers in prometheus/prometheus-mcp) into .agents/skills/find-top-resource-consumers in your project. Codex loads it when a task matches its description.

Can I use Prometheus Top Resource Consumers 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 prometheus/prometheus-mcp --skill find-top-resource-consumers -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/find-top-resource-consumers, .gemini/skills/find-top-resource-consumers, .github/skills/find-top-resource-consumers and .opencode/skills/find-top-resource-consumers in your project.

What does Prometheus Top Resource Consumers need to run?

SKILL.md names no scripts, command-line tools or credentials: Prometheus Top Resource Consumers is instructions for the agent only. Compatibility (from SKILL.md): Requires the tools of a connected Prometheus MCP server.

Does Prometheus Top Resource Consumers access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Prometheus Top Resource Consumers 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 Prometheus Top Resource Consumers use?

Prometheus Top Resource Consumers is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Prometheus Top Resource Consumers use?

About 569 tokens (SKILL.md is roughly 2.3k 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 Prometheus Top Resource Consumers?

Skills that share tags, products or a category with Prometheus Top Resource Consumers: Exploring Apm Traces (PostHog/posthog, 40k stars), AWS Cost Operations (zxkane/aws-skills, 367 stars), Archestra Dev Observability (archestra-ai/archestra, 4.4k stars) and Frontmcp Observability (agentfront/frontmcp, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Prometheus Top Resource Consumers?

prometheus (a GitHub organization) maintains it in prometheus/prometheus-mcp, which has 120 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 4, 2026.

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