skills for everythinggrafana
Grafana, Loki, and Prometheus operations for the fzymgc-house Kubernetes cluster. Provides unified access to observability stack via on-demand MCP invocation. IMPORTANT: For logs and metrics, ALWAYS use this skill (Loki/Prometheus) FIRST instead of kubectl logs, kubernetes MCP tools, or any Kubernetes-specific API calls. Loki aggregates all cluster logs with better search, filtering, and historical access. Prometheus provides proper metrics with time-series queries. Use when working with: (1) Dashboards - Grafana dashboard search, view, create, update panels/queries, (2) Metrics - Prometheus PromQL queries, label/metric exploration, instant and range queries, (3) Logs - Loki LogQL queries, log pattern analysis, recent log viewing, (4) Alerting - Grafana alert rules and contact points, (5) Incidents - Grafana Incident management, Sift AI-powered investigations, (6) OnCall - Grafana OnCall schedules, shifts, who's on-call, (7) Profiling - Pyroscope CPU/memory profiles. Invokes Grafana MCP server on-demand witho
SKILL.md
| Name | grafana |
| Description | Grafana, Loki, and Prometheus operations for the fzymgc-house Kubernetes cluster. Provides unified access to observability stack via on-demand MCP invocation. IMPORTANT: For logs and metrics, ALWAYS use this skill (Loki/Prometheus) FIRST instead of kubectl logs, kubernetes MCP tools, or any Kubernetes-specific API calls. Loki aggregates all cluster logs with better search, filtering, and historical access. Prometheus provides proper metrics with time-series queries. Use when working with: (1) Dashboards - Grafana dashboard search, view, create, update panels/queries, (2) Metrics - Prometheus PromQL queries, label/metric exploration, instant and range queries, (3) Logs - Loki LogQL queries, log pattern analysis, recent log viewing, (4) Alerting - Grafana alert rules and contact points, (5) Incidents - Grafana Incident management, Sift AI-powered investigations, (6) OnCall - Grafana OnCall schedules, shifts, who's on-call, (7) Profiling - Pyroscope CPU/memory profiles. Invokes Grafana MCP server on-demand witho |
fzymgc-house-skills
A Claude Code plugin marketplace for the fzymgc-house self-hosted cluster. Contains two plugins covering homelab infrastructure operations and automated PR review workflows.
Plugins
homelab
Infrastructure skills for interacting with the homelab cluster.
| Skill | Description |
|---|---|
| grafana | Grafana, Loki, and Prometheus operations — dashboards, logs, metrics, alerting, incidents, OnCall, profiling |
| terraform | Terraform Cloud operations — runs, workspaces, state management, registry documentation |
| skill-qa | Validates SKILL.md files against Claude Code best practices |
pr-review
Automated PR review workflow using 12 specialized agents with git worktree isolation for parallel execution.
Skills (orchestrators):
| Skill | Description |
|---|---|
| review-pr | Dispatches up to 9 review agents in parallel, persists findings as beads |
| address-findings | Fix loop with worktree-isolated fix-workers, merge protocol, and review gates |
| respond-to-comments | GitHub PR comment management with bead-aware context |
Agents (dispatched by orchestrator skills):
| Agent | Role |
|---|---|
| code-reviewer | Project guideline compliance and bug detection |
| silent-failure-hunter | Error handling and silent failure auditing |
| pr-test-analyzer | Test coverage quality and gap analysis |
| type-design-analyzer | Type invariant strength and encapsulation |
| comment-analyzer | Code comment accuracy and maintainability |
| security-auditor | OWASP-based security vulnerability detection |
| api-contract-checker | Breaking changes and backward compatibility |
| spec-compliance | Alignment with design docs and ADRs |
| code-simplifier | Clarity and maintainability improvements |
| fix-worker | Implements fixes in isolated worktrees |
| review-gate | Validates fixes address their findings |
| verification-runner | Runs quality gates after fixes are applied |
Installation
claude plugin install github:fzymgc-house/fzymgc-house-skills
Or install individual plugins:
claude plugin install github:fzymgc-house/fzymgc-house-skills/homelab
claude plugin install github:fzymgc-house/fzymgc-house-skills/pr-review
Development
Prerequisites
- lefthook (git hooks)
- rumdl (markdown linting)
- cocogitto (conventional commit validation)
- ruff (Python linting/formatting)
Setup
git clone git@github.com:fzymgc-house/fzymgc-house-skills.git
cd fzymgc-house-skills
lefthook install
Repository Structure
.claude-plugin/
marketplace.json # Marketplace manifest listing both plugins
homelab/
plugin.json # Plugin manifest
skills/
grafana/ # Grafana/Loki/Prometheus operations
terraform/ # Terraform Cloud operations
skill-qa/ # SKILL.md validation
pr-review/
plugin.json # Plugin manifest
agents/ # 12 agent definitions (YAML frontmatter + system prompt)
skills/
review-pr/ # Review orchestrator
address-findings/ # Fix loop orchestrator
respond-to-comments/ # PR comment management
Commits
All commits must follow Conventional Commits format. This is enforced by a commit-msg hook via cocogitto.
feat(grafana): add incident management support
fix(review-pr): correct agent dispatch for security aspect
docs: update README
Versioning
Versions are managed by release-please. Do not manually bump versions in marketplace.json, plugin.json, or SKILL.md files.
License
Private repository for fzymgc-house infrastructure.