@openobserve/skills

Install OpenObserve skills into your AI coding tool — Claude Code, Cursor, VS Code Copilot, or Windsurf.

Skills are composable playbooks that teach your AI assistant how to work with OpenObserve: writing SQL queries, building dashboards, creating alerts, investigating incidents, and more.

Installation

No install needed. Use npx to run directly:

npx @openobserve/skills add --all

Usage

Install a specific skill

npx @openobserve/skills add --skill sre-investigation
npx @openobserve/skills add --skill sql-query
npx @openobserve/skills add --skill dashboard-creation

Install all skills

npx @openobserve/skills add --all

Install into a specific AI tool only

npx @openobserve/skills add --all --tool claude
npx @openobserve/skills add --skill sql-query --tool cursor

Supported values for --tool: claude, cursor, vscode, windsurf

List available skills and install status

npx @openobserve/skills list

Output:

Skill                  Tool               Status
------------------------------------------------
SRE Investigation      Claude Code        ✓ installed
SRE Investigation      Cursor               not installed
SQL Query              Claude Code        ✓ installed
...

Remove a skill

npx @openobserve/skills remove --skill sre-investigation
npx @openobserve/skills remove --skill sql-query --tool claude

Available Skills

| Skill ID | Description | |---|---| | sre-investigation | Incident investigation playbook — root cause analysis, log/metric/trace correlation | | sql-query | Write correct SQL and PromQL queries against OpenObserve streams | | dashboard-creation | Build dashboards and panels | | alert-creation | Create alerts and notification destinations | | pipeline-creation | Build ingestion pipelines | | vrl-scripts | Write VRL transformation scripts | | spl-conversion | Convert Splunk SPL queries to OpenObserve SQL |

How It Works

When you run add, the CLI:

1. Detects which AI tools are installed on your machine
2. Copies the skill files to the correct location for each tool
3. Your AI tool picks them up automatically on next use

Claude Code gets the full multi-file structure (SKILL.md + references/) since it natively supports it.

Cursor, VS Code Copilot, and Windsurf get a single flattened markdown file with all content concatenated.

Install paths

| Tool | Path | |---|---| | Claude Code | ~/.claude/skills/o2-<skill>/ | | Cursor | ~/.cursor/rules/o2-<skill>.md | | VS Code Copilot | .vscode/prompts/o2-<skill>.prompt.md | | Windsurf | ~/.codeium/windsurf/memories/o2-<skill>.md |

Requirements

• Node.js 18+
• One or more of: Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf

Version Alignment

Skill versions are aligned with OpenObserve releases. Use the version matching your OpenObserve installation:

npx @openobserve/[email protected] add --all