notque/vexjoy-agent / skills/infrastructure/kubernetes
kubernetes
FlaggedKubernetes and infrastructure operations: cluster debugging, security and RBAC, manifests and Helm charts, Ansible, Prometheus/Grafana, Perses, OpenSearch/Elasticsearch, RabbitMQ, and cobaltcore tooling.
references/perses.md
View on GitHub# Perses Reference
> **Scope**: The Perses observability platform itself: dashboards, plugins, operator, and core development.
> **Not here**: Grafana or Prometheus dashboards, alerting, and PromQL (`prometheus-grafana.md`); Kubernetes manifests and Helm charts unrelated to Perses (`kubernetes-helm.md`); TypeScript frontend work outside the Perses codebase (`frontend` skill). For Go backend or TypeScript code inside Perses, also load the `programming` or `frontend` skill.
## Areas
- **Core**: Go backend (API handlers, storage, auth), React/TypeScript frontend (dashboard editor, panel rendering), CUE schemas, build system, contribution workflow.
- **Dashboards**: dashboard lifecycle, Dashboard-as-Code (CUE/Go SDK), PromQL/LogQL/TraceQL queries, `percli`, MCP integration, 27 official plugins, CI/CD pipelines.
- **Operator**: Perses Operator CRDs (v1alpha2), Deployment vs StatefulSet, Helm charts, cert-manager, RBAC, monitoring, multi-instance management.
- **Plugins**: plugin architecture (Module Federation, CUE schemas, archive distribution), plugin types (Panel, Datasource, Query, Variable, Explore), `percli plugin` commands, Grafana migration schemas.
## Verification stops
- After designing or changing a dashboard: have I checked it against the existing datasources and available metrics? A dashboard that references a missing datasource or metric fails silently.
- After changing CRDs, Helm values, or operator config: have I checked for breaking changes in dependent dashboards and datasource configs?
## Reference loading table
| Signal | Load | Why |
|---|---|---|
| dashboard, DaC, Dashboard-as-Code, percli, variable, query, datasource, PromQL, panel, timeseries, migrate Grafana | [perses/dashboard.md](perses/dashboard.md) | Dashboard creation and DaC SDK patterns |
| Kubernetes, CRD, operator, Helm, k8s, PersesDashboard, PersesProject, RBAC, cert-manager, manifest | [perses/operator.md](perses/operator.md) | Kubernetes operator CRDs and deployment |
| plugin, Module Federation, CUE schema, scaffold, panel plugin, datasource plugin, percli plugin, webpack | [perses/plugin.md](perses/plugin.md) | Plugin development, CUE schemas, React components |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |