Agent skill · Grafana Labs
PromQL
Officialname: promql★ 290 (repo)pushed 2026-10-24Apache-2.0SKILL.md on GitHubchecked 2026-10-24
Install
The skills CLI copies the skill into the folder of each agent you pick (Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, Windsurf...). Add -g for all projects. Needs Node.js 22.20+. docs
npx skills add grafana/skills --skill promql
This repo is a plugin marketplace. Inside Claude Code, add it and install the plugin that holds the skill (grafana-core, grafana-cloud, grafana-lgtm, grafana-plugins...), or copy only this skill into ~/.claude/skills. docs
/plugin marketplace add grafana/skills /plugin install <plugin>@grafana-skills # or only this skill: npx skills add grafana/skills --skill promql -a claude-code
Download the skill folder, zip it, then Customize > Skills > + > Create skill > Upload a skill. Code execution must be on (Settings > Capabilities). docs
git clone --depth 1 https://github.com/grafana/skills.git /tmp/promql-src cp -r /tmp/promql-src/skills/grafana-core/promql ./promql zip -r promql.zip promql
Codex reads skills from .agents/skills in the repo or ~/.agents/skills. Type $ in Codex to use one. docs
npx skills add grafana/skills --skill promql -a codex
gh skill (GitHub CLI 2.90+, preview) installs it for Copilot in VS Code, the CLI and the cloud agent. Copilot also reads .github/skills and ~/.copilot/skills. docs
gh skill install grafana/skills promql
Cursor reads .cursor/skills, .agents/skills and ~/.cursor/skills (and .claude/skills). It does not install loose skills from a GitHub URL, so copy it in. docs
npx skills add grafana/skills --skill promql -a cursor
Installs from the GitHub repo; --path picks this skill out of the repo. Default scope is user (all projects). docs
gemini skills install https://github.com/grafana/skills.git --path skills/grafana-core/promql
OpenCode reads .opencode/skills, ~/.config/opencode/skills and the Claude and .agents folders. docs
npx skills add grafana/skills --skill promql -a opencode
Windsurf (now Devin Desktop) reads .devin/skills, .windsurf/skills and ~/.codeium/windsurf/skills. docs
npx skills add grafana/skills --skill promql -a windsurf
Pairs with the Prometheus MCP server, Grafana MCP server: the server gives the agent the tools, the skill teaches it how to use them.
More from grafana/skills
- k6 Load Testing: Writes and reviews k6 scripts for load, stress, soak and browser tests.
Other data & analytics skills
- BigQuery Basics · Google
- PostHog Feature Flags (React) · PostHog
- PostHog for Next.js (App Router) · PostHog
FAQ
How do I install the promql skill?+
Run npx skills add grafana/skills --skill promql and pick your agents, or use the tab for your agent above. In Claude Code the skill ends up in ~/.claude/skills/promql/SKILL.md.
Which agents can use PromQL?+
Any agent that reads the Agent Skills format (SKILL.md): Claude Code, the Claude apps, Codex, GitHub Copilot, Cursor, Gemini CLI, OpenCode, Windsurf and more.
Who maintains PromQL?+
Grafana Labs, the company or project behind it, in the grafana/skills repo on GitHub, last pushed 2026-10-24.
Read a skill's SKILL.md and scripts before you install it: skills aren't verified by any agent vendor. All agent skills · MCP servers