Agent skill

Opik Local Dev Environment

by comet-ml in comet-ml/opik

Starts, rebuilds, and troubleshoots the Opik local dev stack, including an optional Comet Platform integration mode for the Opik team.

Apache-2.0Auto-check passedDevOps & Cloud

Install Opik Local Dev Environment

skills CLI
$ npx skills add comet-ml/opik --skill local-dev -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install comet-ml/opik local-dev --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/comet-ml/opik.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/local-dev .claude/skills/local-dev && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
local-dev
GitHub stars
22k
Token cost
~734 tokens
SKILL.md length
124 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

Starts, rebuilds, and troubleshoots the Opik local dev stack, including an optional Comet Platform integration mode for the Opik team.

  • Starting the Opik local development environment
  • SKILL.md covers Quick Start, Modes, URLs and Build Commands, plus 3 more sections
  • Calls docker, mvn and npm
  • Rebuilding just the backend or frontend after a change

What it does

This skill uses a single dev-runner script that handles full restarts, daily starts without rebuilding, stopping everything, and backend-only restarts for faster iteration, serving the frontend on one local port in standard mode and a different port in backend-only mode, with the backend API and its health check on a fixed port.

An opt-in Platform mode, off by default, runs the Comet EM/Platform stack alongside Opik behind a single-origin nginx proxy for Opik-team members only, auto-detecting sibling comet-backend and comet-react checkouts and building comet-backend under a detected JDK 17 or 21 while Opik itself stays on JDK 25. Troubleshooting commands cover verifying the stack, checking for a port conflict, and a clean stop-then-restart.

When your agent uses it

  • Starting the Opik local development environment
  • Rebuilding just the backend or frontend after a change
  • Running Opik connected to the Comet Platform stack for internal testing

Example prompts

  • “Start the Opik dev environment for frontend work.”
  • “Rebuild just the backend after my change.”
  • “Run Opik in Platform mode connected to comet-backend.”

Requirements

  • Docker
  • JDK 17/21 for Platform mode, JDK 25 for Opik

What it can do on your machine

Read from SKILL.md and the folder at commit f217a86. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • docker
    • mvn
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use docker and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Opik Local Dev Environment loads about 734 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 124 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~734

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from comet-ml/opik at commit f217a86, republished under its Apache-2.0 licence (© comet-ml). 124 words, ~734 tokens.

Download SKILL.mdSave it as .claude/skills/local-dev/SKILL.md (or your agent's skills folder).
name
local-dev
description
Local development environment setup and commands. Use when helping with dev server, Docker, or local testing.

Local Development

Quick Start

bash
./scripts/dev-runner.sh --restart   # First time / full rebuild
./scripts/dev-runner.sh --start     # Daily start (no rebuild)
./scripts/dev-runner.sh --stop      # Stop everything
./scripts/dev-runner.sh --verify    # Check status

Modes

ModeCommandFrontendUse When
Standard--restartlocalhost:5174Frontend work, full-stack
BE-only--be-only-restartlocalhost:5173Backend-focused, faster rebuilds
Platform (EM)PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restartlocalhost:9100Opik-team only: run Opik connected to the Comet Platform
Platform (EM) mode — Opik-team only

PLATFORM_ENABLED=true runs the Comet EM/Platform stack (comet-backend + comet-react, auto-detected sibling checkouts) alongside Opik behind a single-origin nginx proxy, with Opik in comet mode authenticating/resolving workspaces via comet-backend. Off by default — Standard/BE-only dev is unaffected. comet-backend builds under a detected JDK 17/21; Opik still uses JDK 25.

bash
PLATFORM_ENABLED=true ./scripts/dev-runner.sh --restart   # then also --start/--stop/--verify
# Integrated UI:  http://localhost:9100        (comet-react / Platform)
#                 http://localhost:9100/opik   (Opik, comet mode)

Env vars (COMET_BACKEND_PATH, COMET_REACT_PATH, PLATFORM_JAVA_HOME, PLATFORM_*_PORT) and --platform-build are documented in ./scripts/dev-runner.sh --help.

URLs

Build Commands

bash
./scripts/dev-runner.sh --build-be   # Backend only
./scripts/dev-runner.sh --build-fe   # Frontend only
./scripts/dev-runner.sh --lint-be    # Spotless
./scripts/dev-runner.sh --lint-fe    # ESLint
./scripts/dev-runner.sh --migrate    # DB migrations

Logs

bash
tail -f /tmp/opik-backend.log        # Backend
tail -f /tmp/opik-frontend.log       # Frontend (standard)
docker logs -f opik-frontend-1       # Frontend (BE-only)

SDK Config

bash
export OPIK_URL_OVERRIDE='http://localhost:8080'
export OPIK_WORKSPACE='default'

Troubleshooting

Won't start:

bash
./scripts/dev-runner.sh --verify
lsof -i :8080                        # Port conflict?
./scripts/dev-runner.sh --stop && ./scripts/dev-runner.sh --restart

Build fails:

bash
cd apps/opik-backend && mvn clean install -DskipTests
cd apps/opik-frontend && rm -rf node_modules && npm install

Database issues:

bash
./scripts/dev-runner.sh --stop
./opik.sh --clean                    # WARNING: deletes data
./scripts/dev-runner.sh --restart

© comet-ml, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/local-dev of comet-ml/opik.

Open the folder on GitHubat commit f217a86

Compare with similar skills

Opik Local Dev Environment next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Opik Local Dev Environment compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Opik Local Dev Environment this skillcomet-ml/opik22k—~734Automated safety check: PassApache-2.0
Docker Jfr Benchmark Loopeclipse-rdf4j/rdf4j420—~945Automated safety check: PassBSD-3-Clause
Oci Functions Deployoracle/skills872—~4.6kAutomated safety check: PassUPL-1.0
Writing Dockerfilesancoleman/ai-design-components526—~3.2kAutomated safety check: NotesMIT
706 Technologies Containers Dockerjabrena/plinth445—~1.4kAutomated safety check: PassApache-2.0
Containerization AssistantArabelaTso/Skills-4-SE253—~2.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Docker Jfr Benchmark Loop

    eclipse-rdf4j/rdf4j

    Run a repeatable RDF4J performance loop against one JMH benchmark in Docker with Linux Java 26 and JFR CPU-time profiling.

    420 GitHub stars~945 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Official

    Build, configure, scaffold, and deploy OCI Functions from a local machine using a dependency-first, Fn-context-guided flow with argv-safe mutation execution, nonce-scoped confirmations, and a…

    872 GitHub stars~4.6k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Writing Dockerfiles

    ancoleman/ai-design-components

    Writing optimized, secure, multi-stage Dockerfiles with language-specific patterns (Python, Node.js, Go, Rust), BuildKit features, and distroless images.

    526 GitHub stars~3.2k tokensUpdated 10 mo ago
    DevOps & CloudAuto-check: notes
  • A skill your agent uses when you need framework-agnostic Docker and container image guidance for Java projects - Dockerfile design, multi-stage Maven builds, jlink custom runtimes, micro runtime…

    445 GitHub stars~1.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Containerization Assistant

    ArabelaTso/Skills-4-SE

    Generate Dockerfiles, Docker Compose configurations, and Kubernetes manifests for containerizing applications.

    253 GitHub stars~2.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Java Install Skill

    jiushiwon/wg-skills

    Java 安装子技能。支持 apt/dnf/Docker 方式安装指定版本的 JDK,幂等检测,已安装则提示。当用户说「安装 Java」「装 Java」时触发。

    110 GitHub stars~299 tokensUpdated 3 days ago
    DevOps & CloudAuto-check passed

More from comet-ml/opik

All 19 skills in this repo
  • Checklist for wiring a new linter into Opik's Code Quality pipeline: the four files to edit, the silent-failure gotchas and the pass/fail verification loop.

    22k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Shows how to add product analytics events to Opik's frontend, Java backend and Python SDK, all reporting through Segment to PostHog with an opik_ name prefix.

    22k GitHub stars~4.4k tokensUpdated today
    Auto-check passed
  • Investigates a failed Opik end-to-end test from CI, TestOps or a local run, decides regression versus flake, and proposes a fix without editing tests.

    22k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Rules for writing PR descriptions, changelog entries and feature documentation in the Opik repository, including the exact headings that CI requires.

    22k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Turns a code change into one committed, passing Playwright end-to-end spec by resolving the change scope and handing authoring to a companion skill.

    22k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Specifies how to instrument an opik-backend pipeline with per-stage OpenTelemetry metrics for throughput, latency, errors and queue delay by workspace.

    22k GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Opik Local Dev Environment

What does Opik Local Dev Environment do?

Starts, rebuilds, and troubleshoots the Opik local dev stack, including an optional Comet Platform integration mode for the Opik team. This skill uses a single dev-runner script that handles full restarts, daily starts without rebuilding, stopping everything, and backend-only restarts for faster iteration, serving the frontend on one local port in standard mode and a different port in backend-only mode, with the backend API and its health check on a fixed port.

When should I use Opik Local Dev Environment?

Opik Local Dev Environment fits situations like: starting the Opik local development environment; rebuilding just the backend or frontend after a change; running Opik connected to the Comet Platform stack for internal testing.

How do I install Opik Local Dev Environment in Claude Code?

Run `npx skills add comet-ml/opik --skill local-dev -a claude-code`. Or copy the skill folder (.agents/skills/local-dev in comet-ml/opik) into .claude/skills/local-dev in your project. Claude Code loads it when a task matches its description.

How do I install Opik Local Dev Environment in Codex?

Run `npx skills add comet-ml/opik --skill local-dev -a codex`. Or copy the skill folder (.agents/skills/local-dev in comet-ml/opik) into .agents/skills/local-dev in your project. Codex loads it when a task matches its description.

Can I use Opik Local Dev Environment in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add comet-ml/opik --skill local-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-dev, .gemini/skills/local-dev, .github/skills/local-dev and .opencode/skills/local-dev in your project.

What does Opik Local Dev Environment need to run?

Going by SKILL.md and its folder, Opik Local Dev Environment needs the command-line tools its instructions call (docker, mvn and npm). Our summary lists: Docker; JDK 17/21 for Platform mode, JDK 25 for Opik.

Does Opik Local Dev Environment access the network?

SKILL.md contains no URLs. Its commands use docker and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Opik Local Dev Environment safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Opik Local Dev Environment use?

Opik Local Dev Environment is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Opik Local Dev Environment use?

About 734 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Opik Local Dev Environment?

Skills that share tags, products or a category with Opik Local Dev Environment: Docker Jfr Benchmark Loop (eclipse-rdf4j/rdf4j, 420 stars), Oci Functions Deploy (oracle/skills, 872 stars), Writing Dockerfiles (ancoleman/ai-design-components, 526 stars) and 706 Technologies Containers Docker (jabrena/plinth, 445 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Opik Local Dev Environment?

comet-ml (a GitHub organization) maintains it in comet-ml/opik, which has 22,412 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

Source: comet-ml/opik on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.