Agent skill

Ops Report

by haacked in haacked/dotfiles

Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus metrics.

No licenceAuto-check: notesDevOps & Cloud

Install Ops Report

skills CLI
$ npx skills add haacked/dotfiles --skill ops-report -a claude-code

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

GitHub CLI
$ gh skill install haacked/dotfiles ops-report --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/haacked/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/ai/skills/ops-report .claude/skills/ops-report && 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
ops-report
GitHub stars
134
Token cost
~8k tokens
SKILL.md length
4,115 words
Files
3 (incl. references)
Skills in repo
29
Repo updated
First seen
Licence
None found

At a glance

Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus metrics.

  • Works in 11 steps: Parse Arguments and Validate → Discover Dashboards → Discover Datasources → …
  • Tasks that involve Monitoring and alerting
  • SKILL.md covers Arguments (parsed from user…, MCP Server Mapping, Your Task and Assessment Criteria, plus 1 more section
  • Calls npx and swift

What it does

Ops Report is an agent skill from haacked/dotfiles. Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus metrics. Produces a formatted markdown report with key metrics, anomalies, and recommendations.

Its SKILL.md is about 8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/capacity-checks.md` and `templates/report-template.md`).

It sits in DevOps & Cloud, covering Monitoring and alerting. It works with Grafana, PostHog, Prometheus and Model Context Protocol. The repository describes itself as: My dotfiles and scripts I use on dev machines.

When your agent uses it

  • Tasks that involve Monitoring and alerting

Example prompts

  • “/ops-report”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Grep, Glob, Write, Edit, mcp__grafana__search_dashboards, mcp__grafana__get_dashboard_panel_queries, mcp__grafana__query_prometheus, mcp__grafana__query_prometheus_histogram, mcp__grafana__list_datasources, mcp__grafana__generate_deeplink, mcp__grafana__query_loki_logs, mcp__grafana__query_loki_stats, mcp__grafana__list_loki_label_names, mcp__grafana__list_loki_label_values, mcp__grafana-eu__search_dashboards, mcp__grafana-eu__get_dashboard_panel_queries, mcp__grafana-eu__query_prometheus, mcp__grafana-eu__query_prometheus_histogram, mcp__grafana-eu__list_datasources, mcp__grafana-eu__generate_deeplink, mcp__grafana-eu__query_loki_logs, mcp__grafana-eu__query_loki_stats, mcp__grafana-eu__list_loki_label_names, mcp__grafana-eu__list_loki_label_values

Workflow steps

11 steps, taken from the step headings in SKILL.md.

  1. Parse Arguments and Validate
  2. Discover Dashboards
  3. Discover Datasources
  4. Extract Key Queries from Dashboards
  5. Query Metrics
  6. Analyze Results
  7. Generate Dashboard Links
  8. Investigate Anomalies via Loki Logs
  9. Write the Report
  10. Token Usage, Lint, and Confirm
  11. Copy Slack Summary

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Grep
    • Glob
    • Write
    • Edit
    • mcp__grafana__search_dashboards
    • mcp__grafana__get_dashboard_panel_queries
    • mcp__grafana__query_prometheus
    • mcp__grafana__query_prometheus_histogram

    …and 16 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • swift

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

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    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

Ops Report loads about 8k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 4,115 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~11k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Grep, Glob, Write, Edit, mcp__grafana__search_dashboards, mcp__grafana__get_dashboard_pa

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 4,115 words (~8,029 tokens).

“Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus/VictoriaMetrics metrics.”

— opening of SKILL.md by haacked
name
ops-report
allowed-tools
Bash, Read, Grep, Glob, Write, Edit, mcp__grafana__search_dashboards, mcp__grafana__get_dashboard_panel_queries, mcp__grafana__query_prometheus, mcp__grafana__query_prometheus_histogram, mcp__grafana__list_datasources, mcp__grafana__generate_deeplink, mcp__grafana__query_loki_logs, mcp__grafana__query_loki_stats, mcp__grafana__list_loki_label_names, mcp__grafana__list_loki_label_values, mcp__grafana-eu__search_dashboards, mcp__grafana-eu__get_dashboard_panel_queries, mcp__grafana-eu__query_prometheus, mcp__grafana-eu__query_prometheus_histogram, mcp__grafana-eu__list_datasources, mcp__grafana-eu__generate_deeplink, mcp__grafana-eu__query_loki_logs, mcp__grafana-eu__query_loki_stats, mcp__grafana-eu__list_loki_label_names, mcp__grafana-eu__list_loki_label_values
model
sonnet
metadata.execution-tier
balanced
color
green
argument-hint
[service] [--window day|week|month] [--region us|eu|both]

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in ai/skills/ops-report of haacked/dotfiles.

  • SKILL.md
  • references/capacity-checks.md
  • templates/report-template.md

Open the folder on GitHubat commit 23ffed9

Compare with similar skills

Ops Report 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.

Ops Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ops Report this skillhaacked/dotfiles134—~8kAutomated safety check: NotesNone
Syncmetapawurb/hotpath-rs1.9k—~1.2kAutomated safety check: NotesMIT
Archestra Dev Observabilityarchestra-ai/archestra4.4k—~1.2kAutomated safety check: PassCustom licence
Frontmcp Observabilityagentfront/frontmcp146—~4.6kAutomated safety check: PassApache-2.0
Live Debugmacro-inc/macro4.6k—~2.4kAutomated safety check: NotesAGPL-3.0
Analyzing Experiment Precompute CanaryPostHog/posthog40k—~3.5kAutomated safety check: PassCustom licence

Similar skills

  • Syncmeta

    pawurb/hotpath-rs

    Sync changes from the hotpath, hotpath-macros and hotpath-drain crates to their meta counterparts (hotpath-meta, hotpath-macros-meta and hotpath-drain-meta).

    1.9k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • 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 yesterday
    DevOps & CloudAuto-check passed
  • Live Debug

    macro-inc/macro

    Debug the running local stack with traces, logs, and a shared headless browser.

    4.6k GitHub stars~2.4k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Analyze the experiment precompute result-consistency canary across prod-US and prod-EU, deep-dive any issues, and produce an actionable report.

    40k GitHub stars~3.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Official

    Guide for using the Grafana MCP to monitor and diagnose the capture service (rust/capture) in production.

    40k GitHub stars~5k tokensUpdated today
    DevOps & CloudAuto-check passed

More from haacked/dotfiles

All 29 skills in this repo
  • Support

    haacked/dotfiles

    Support hero workflow — start a ticket investigation with auto-organized notes, find existing notes, or generate the weekly highlights log.

    134 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Analyze Permissions

    haacked/dotfiles

    Analyze accumulated permissions and suggest smart wildcard patterns.

    134 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Followup

    haacked/dotfiles

    Capture a follow-up item mid-session in seconds, list open items, close one, or run a review pass.

    134 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Handoff

    haacked/dotfiles

    Write or resume a handoff document so the next agent session can pick up the current work.

    134 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Note

    haacked/dotfiles

    Capture complex technical discoveries into structured, reusable notes.

    134 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Quarterly Planning

    haacked/dotfiles

    Draft quarterly goals for a PostHog team (defaults to Feature Flags), clustering open issues into themes and producing goals in PostHog's HOGS format.

    134 GitHub stars~3.1k tokensUpdated today
    Auto-check passed

Categories

Questions about Ops Report

What does Ops Report do?

Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus metrics. Ops Report is an agent skill from haacked/dotfiles. Generate a 24-hour operational health report for a PostHog service by querying Grafana dashboards and Prometheus metrics.

When should I use Ops Report?

Ops Report fits situations like: tasks that involve Monitoring and alerting.

How do I install Ops Report in Claude Code?

Run `npx skills add haacked/dotfiles --skill ops-report -a claude-code`. Or copy the skill folder (ai/skills/ops-report in haacked/dotfiles) into .claude/skills/ops-report in your project. Claude Code loads it when a task matches its description.

How do I install Ops Report in Codex?

Run `npx skills add haacked/dotfiles --skill ops-report -a codex`. Or copy the skill folder (ai/skills/ops-report in haacked/dotfiles) into .agents/skills/ops-report in your project. Codex loads it when a task matches its description.

Can I use Ops Report 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 haacked/dotfiles --skill ops-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ops-report, .gemini/skills/ops-report, .github/skills/ops-report and .opencode/skills/ops-report in your project.

What does Ops Report need to run?

Going by SKILL.md and its folder, Ops Report needs the command-line tools its instructions call (npx and swift). Its frontmatter pre-approves these tools: Bash, Read, Grep, Glob, Write, Edit, mcp__grafana__search_dashboards, mcp__grafana__get_dashboard_panel_queries, mcp__grafana__query_prometheus, mcp__grafana__query_prometheus_histogram, mcp__grafana__list_datasources, mcp__grafana__generate_deeplink, mcp__grafana__query_loki_logs, mcp__grafana__query_loki_stats, mcp__grafana__list_loki_label_names, mcp__grafana__list_loki_label_values, mcp__grafana-eu__search_dashboards, mcp__grafana-eu__get_dashboard_panel_queries, mcp__grafana-eu__query_prometheus, mcp__grafana-eu__query_prometheus_histogram, mcp__grafana-eu__list_datasources, mcp__grafana-eu__generate_deeplink, mcp__grafana-eu__query_loki_logs, mcp__grafana-eu__query_loki_stats, mcp__grafana-eu__list_loki_label_names, mcp__grafana-eu__list_loki_label_values.

Does Ops Report access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ops Report safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Ops Report use?

No licence was found for Ops Report or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Ops Report use?

About 8k tokens (SKILL.md is roughly 32k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.5k tokens, read only when the agent opens those files.

What are the alternatives to Ops Report?

Skills that share tags, products or a category with Ops Report: Syncmeta (pawurb/hotpath-rs, 1.9k stars), Archestra Dev Observability (archestra-ai/archestra, 4.4k stars), Frontmcp Observability (agentfront/frontmcp, 146 stars) and Live Debug (macro-inc/macro, 4.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ops Report?

haacked (a GitHub user) maintains it in haacked/dotfiles, which has 134 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 8, 2026.

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