notque/perses
skills/perses/SKILL.md
Perses platform operations: dashboards, plugins, deployment, migration, and quality.
$ install --global
skillsauthnpx skillsauth add notque/claude-code-toolkit persesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 6:27 AM17.4s10 files scanned
SKILL.md
- name:
- perses
- description:
- Perses platform operations: dashboards, plugins, deployment, migration, and quality.
- context:
- fork
- agent:
- perses-engineer
- force_route:
- true
- category:
- infrastructure
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
Preferred 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.
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 |
Reference Loading Table
| 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 |
Related Skills
notque/shell-config
tools
VerifiedTrustedCommunity
Shell configuration: Fish and Zsh setup, PATH, completions, plugins.
412SKILL.mdUpdated Jul 6, 2026
notque/kubernetes
tools
VerifiedTrustedCommunity
Kubernetes operations: debugging, security, RBAC, and infrastructure tooling.
412SKILL.mdUpdated Jul 6, 2026
notque/swift
development
VerifiedTrustedCommunity
Swift development: concurrency patterns, async/await, actors, testing with XCTest and Swift Testing framework.
412SKILL.mdUpdated Jul 6, 2026
notque/php
development
VerifiedTrustedCommunity
PHP development: code quality, PSR standards, testing with PHPUnit.
412SKILL.mdUpdated Jul 6, 2026