skills/perses/SKILL.md
Perses platform operations: dashboards, plugins, deployment, migration, and quality.
npx skillsauth add notque/claude-code-toolkit persesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Umbrella skill for all Perses platform operations.
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.
Read tool on ${CLAUDE_SKILL_DIR}/references/<name>.mdPreferred action: Load the reference files before Perses operations. They contain the percli commands, CUE schema patterns, and deployment procedures specific to this toolkit's Perses setup.
| 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 |
| Signal | Load These Files | Why |
|---|---|---|
| First-time setup, server deployment | onboard-deploy.md | New Perses installation or server configuration |
| Create or review dashboards | dashboard.md | Any dashboard CRUD operation |
| Manage datasources or variables | datasource-variable.md | Connecting data sources or template variables |
| Plugin development and testing | plugin.md | Building or testing Perses plugins |
| Grafana migration | migration.md | Converting Grafana dashboards to Perses |
| PromQL/LogQL/TraceQL queries | query.md | Writing or debugging queries |
| Project and RBAC management | project.md | Multi-tenant setup or permissions |
| Linting, code review, CUE schemas | quality.md | Code quality or CUE schema work |
| Dashboard-as-Code pipeline | dac.md | GitOps or CI/CD for dashboards |
documentation
Document translation: quick/normal/refined modes with chunked parallel subagents and glossary support.
development
AI image generation: Gemini and Nano Banana backends; single/series/batch workflows with prompt-to-disk.
testing
Unified voice content generation pipeline with mandatory validation and joy-check. 13-phase pipeline: LOAD, GROUND, STATS-CHECKPOINT, GENERATE, HOOK-GATE, VALIDATE, REFINE, VARIETY-GATE, JOY-CHECK, ANTI-AI, CLOSE-GATE, 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".
documentation
Critique-and-rewrite loop for voice fidelity validation.