monitoring-mimir

Lint Grafana Mimir alerting rule files and sync validated rules to Grafana Cloud.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gakonst/dotfiles --skill monitoring-mimir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monitoring-mimir
Source: https://github.com/gakonst/dotfiles/tree/main/.codex/skills/monitoring-mimir
Command: npx skills add https://github.com/gakonst/dotfiles --skill monitoring-mimir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures the health and consistency of Grafana Mimir alerting rules by automating their validation and synchronization. It prevents misconfigurations, out-of-sync rules, and unnecessary CI runs, guaranteeing that monitoring and alerting systems are always accurate and up-to-date.

Core Features & Use Cases

  • Automated Rule Validation: Lints Mimir rule files (.yml) on every pull request using mimirtool rules lint, catching syntax and logical errors early.
  • Main Branch Synchronization: Automatically syncs validated rules to Grafana Cloud upon pushes to the main branch, ensuring production environments reflect the latest changes.
  • Path-Filtered Workflows: Uses GitHub Actions path filters to trigger validation and sync jobs only when Mimir rule files are modified, optimizing CI resource usage.
  • Use Case: When a team member proposes a new alerting rule, the PR automatically lints the rule file, providing immediate feedback on its correctness before it can be merged and deployed to production.

Quick Start

To validate your Mimir alerting rules locally before committing, run 'just mimir-lint' in your repository's root directory.