Agent skill
perses
Perses platform operations: dashboards, plugins, deployment, migration, and quality.
Install this agent skill to your Project
npx add-skill https://github.com/notque/claude-code-toolkit/tree/main/skills/perses
SKILL.md
Perses Operations
Umbrella skill for all Perses platform operations.
How to Use (MANDATORY)
You MUST load the matching reference file before starting any Perses work. The table below routes tasks to domain-specific references containing the actual methodology, commands, and patterns.
- Match the user's task to a sub-domain in the table below
- Load the reference file using
Readtool on${CLAUDE_SKILL_DIR}/references/<name>.md - Follow the instructions in the loaded reference exactly
- If the task spans multiple sub-domains, load each relevant reference
Anti-pattern: Do NOT attempt Perses operations from general knowledge alone. The reference files contain percli commands, CUE schema patterns, and deployment procedures specific to this toolkit's Perses setup.
Sub-domains
| Task | Reference | When to Load |
|---|---|---|
| First-time setup, server deployment | references/onboard-deploy.md |
New Perses installation or server configuration |
| Create or review dashboards | references/dashboard.md |
Any dashboard CRUD operation |
| Manage datasources or variables | references/datasource-variable.md |
Connecting data sources or template variables |
| Plugin development and testing | references/plugin.md |
Building or testing Perses plugins |
| Grafana migration | references/migration.md |
Converting Grafana dashboards to Perses |
| PromQL/LogQL/TraceQL queries | references/query.md |
Writing or debugging queries |
| Project and RBAC management | references/project.md |
Multi-tenant setup or permissions |
| Linting, code review, CUE schemas | references/quality.md |
Code quality or CUE schema work |
| Dashboard-as-Code pipeline | references/dac.md |
GitOps or CI/CD for dashboards |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
voice-writer
Unified voice content generation pipeline with mandatory validation and joy-check. 9-phase pipeline: LOAD, GROUND, GENERATE, VALIDATE, REFINE, JOY-CHECK, OUTPUT, CLEANUP. Use when writing articles, blog posts, or any content that uses a voice profile. Use for "write article", "blog post", "write in voice", "generate content", "draft article", "write about".
image-auditor
Non-destructive image validation for accessibility and health.
video-editing
Video editing pipeline: cut footage, assemble clips via FFmpeg and Remotion.
comment-quality
Review and fix temporal references in code comments.
e2e-testing
Playwright-based end-to-end testing workflow.
anti-ai-editor
Remove AI-sounding patterns from content.
Didn't find tool you were looking for?