prometheus-metrics-specialist

Instrument services with Prometheus metrics and expose a /metrics endpoint.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/paunchygent/docforge --skill prometheus-metrics-specialist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prometheus-metrics-specialist
Source: https://github.com/paunchygent/docforge/tree/main/frontend/.claude/skills/prometheus-metrics
Command: npx skills add https://github.com/paunchygent/docforge --skill prometheus-metrics-specialist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams instrument services using Prometheus, establish naming conventions, expose a /metrics endpoint, and craft PromQL queries for dashboards and alerts.

Core Features & Use Cases

  • Naming Patterns: Service-prefixed operational metrics vs. business metrics
  • Instrumentation: Metrics middleware to expose /metrics
  • PromQL Guidance: PromQL basics, error rates, latency percentiles, and troubleshooting patterns
  • Reference Documentation: Access to fundamentals, naming conventions, and examples

Quick Start

Expose /metrics on your service and apply the standard naming pattern to your metrics; write a few PromQL queries to validate dashboards.

Frequently Asked Questions about prometheus-metrics-specialist

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I instrument my services with Prometheus metrics?

Instrument services by exposing a /metrics endpoint and applying standard naming conventions to Counter, Histogram, and Gauge metrics. Add metrics middleware to capture HTTP endpoints, database queries, Kafka events, and business logic, then write PromQL queries to validate dashboards and alerts.

What naming conventions should I use for Prometheus metrics?

Use service-prefixed operational metrics for infrastructure (latency, error rates, throughput) and separate business-metrics patterns for domain logic. Follow consistent label design and naming schemes to enable cross-service aggregation and readable PromQL queries.

How do I write PromQL queries for dashboards and alerts?

PromQL queries calculate error rates, latency percentiles, and troubleshooting patterns from your exposed metrics. Start with basic aggregation queries on Counter, Histogram, and Gauge data, then refine for dashboard visualization and alert thresholds.

Can I apply Prometheus metrics to Kafka event processing and LLM API calls?

Yes. Instrument Kafka event processing, LLM API calls, batch jobs, and database queries alongside HTTP endpoints using the same middleware and naming patterns, ensuring consistent service- and business-metrics instrumentation across all workload types.

What middleware integration is needed to expose metrics automatically?

Metrics middleware intercepts HTTP endpoints, database queries, and other operations to automatically collect Counter, Histogram, and Gauge data. Configure it to expose aggregated metrics at /metrics and align with your service's naming and label design.