A skill your agent uses for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting.

Apache-2.0Auto-check passedDevOps & Cloud

Install Vss Observability

skills CLI
$ npx skills add open-edge-platform/edge-ai-libraries --skill vss-observability -a claude-code

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

GitHub CLI
$ gh skill install open-edge-platform/edge-ai-libraries vss-observability --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/open-edge-platform/edge-ai-libraries.git skills-src && mkdir -p .claude/skills && cp -r skills-src/sample-applications/video-search-and-summarization/.github/skills/vss-observability .claude/skills/vss-observability && 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
vss-observability
GitHub stars
169
Token cost
~913 tokens
SKILL.md length
324 words
Files
14 (incl. scripts, references)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting.

  • Works in 2 steps: Live system and dataprep metrics use… → Pipeline Manager traces use the Node…
  • VSS live metrics
  • SKILL.md covers Environment setup, What observability exists, Enable and verify live metrics and Enable traces, plus 1 more section
  • Runs Shell scripts from its folder; calls curl and bash

What it does

Vss Observability is an agent skill from open-edge-platform/edge-ai-libraries. Use this skill for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting. It is grounded in the Metrics Manager Compose/Helm integration and Pipeline Manager OTel wiring.

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `BENCHMARK.md`, `evals/evals.json` and `evals/trigger-evals.json`).

It sits in DevOps & Cloud, covering Observability and Container orchestration. It works with OpenTelemetry, Docker and NGINX. The repository describes itself as: Libraries, microservices, tools, and other reference software, supporting development of performance-optimized Edge AI applications. The licence is Apache-2.0.

When your agent uses it

  • VSS live metrics
  • OpenTelemetry traces
  • Pipeline bottlenecks
  • Metrics-panel troubleshooting

Example prompts

  • “/vss-observability”

Requirements

  • A Bash shell
  • Docker

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Live system and dataprep metrics use Metrics Manager. Set
  2. Pipeline Manager traces use the Node OpenTelemetry SDK. OTLP_TRACE_URL

What it can do on your machine

Read from SKILL.md and the folder at commit 3084578. 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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • curl
    • bash

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

  • Network

    No URLs in SKILL.md. Its commands use curl, 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

Vss Observability loads about 913 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 324 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~913
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from open-edge-platform/edge-ai-libraries at commit 3084578, republished under its Apache-2.0 licence (© open-edge-platform). 324 words, ~913 tokens.

Download SKILL.mdSave it as .claude/skills/vss-observability/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
vss-observability
description
Use this skill for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting. It is grounded in the Metrics Manager Compose/Helm integration and Pipeline Manager OTel wiring.

VSS Observability

Use this only for sample-applications/video-search-and-summarization. Check docker/compose.metrics-manager.yaml, config/nginx/nginx.conf, ui/react/src/components/Search/TelemetryAccordion.tsx, pipeline-manager/src/tracing.ts, and setup.sh before giving operational advice.

Environment setup

Run the bundled bootstrap and work from the resolved app root:

bash
SKILL_DIR=".github/skills/vss-observability"
APP_ROOT="$(bash "$SKILL_DIR/scripts/vss-bootstrap.sh")"
cd "$APP_ROOT"

What observability exists

VSS has two independent paths:

  1. Live system and dataprep metrics use Metrics Manager. Set ENABLE_METRICS_MANAGER=true in a search-enabled Compose deployment. docker/compose.metrics-manager.yaml starts docker.io/intel/metrics-manager:2026.2.0-20260715-weekly. DataPrep sends dataprep_embeddings_per_second to its simple-metrics REST API, and the UI consumes its SSE stream through nginx.
  2. Pipeline Manager traces use the Node OpenTelemetry SDK. OTLP_TRACE_URL selects an external OTLP HTTP endpoint; when it is empty, spans use the console exporter in Pipeline Manager logs. The service name is videoSummary.

VSS does not bundle Jaeger, Tempo, an OpenTelemetry Collector, or a trace UI.

Enable and verify live metrics

bash
ENABLE_METRICS_MANAGER=true source setup.sh --search
# or
ENABLE_METRICS_MANAGER=true source setup.sh --summary --search

curl -f http://localhost:12345/metrics-manager/health
curl -N http://localhost:12345/metrics-manager/metrics/stream
curl http://localhost:9273/metrics | head

The nginx routes are deliberately limited to /metrics-manager/health and /metrics-manager/metrics/stream. The browser uses EventSource, reconnects automatically, and marks data stale when events stop. Metrics Manager provides CPU, RAM, GPU, and NPU values when the corresponding host devices exist; DataPrep publishes embedding throughput asynchronously. Missing accelerator metrics are valid on hosts without those devices.

Enable traces

bash
OTLP_TRACE_URL=http://<trace-backend>:4318/v1/traces \
  source setup.sh --summary --search

No credentials or headers are configured by VSS, so use an endpoint reachable without them or extend the trace exporter explicitly.

Follow a video and find bottlenecks

  • Save videoId from POST /manager/videos and summaryPipelineId (the stateId) from POST /manager/summary.
  • Filter the trace backend for service videoSummary and the matching time window. Current auto-instrumented spans do not add those IDs as custom span attributes.
  • Inspect EVAM start/status requests for chunking, outbound VLM completion requests for captioning, outbound LLM completion requests for final summarization, and DataPrep calls for embedding/indexing.
  • Cross-check /manager/summary/<stateId>/raw, /manager/pipeline/evam, and /manager/pipeline/frames.
  • Compare slow DataPrep calls with dataprep_embeddings_per_second in the SSE stream. Compare model latency with CPU/RAM/GPU/NPU saturation.

Metrics delivery failures do not imply trace failures, and missing metrics do not stop ingestion. search-ms does not currently have application-level OTel trace wiring.

For API payloads, environment variables, and troubleshooting detail, read references/telemetry-setup.md.

© open-edge-platform, 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

SKILL.md and 13 other files (scripts, references) in sample-applications/video-search-and-summarization/.github/skills/vss-observability of open-edge-platform/edge-ai-libraries.

  • SKILL.md
  • BENCHMARK.md
  • evals/evals.json
  • evals/trigger-evals.json
  • example-prompts/01-enable-telemetry-overlay.md
  • example-prompts/02-configure-otel-trace-export.md
  • example-prompts/03-trace-video-end-to-end.md
  • example-prompts/04-diagnose-slow-processing.md
  • example-prompts/05-check-collector-health-and-metrics.md
  • example-prompts/06-clarify-telemetry-scope.md
  • example-prompts/07-bootstrap-fresh-machine.md
  • example-prompts/README.md
  • references/telemetry-setup.md
  • scripts/vss-bootstrap.sh

Open the folder on GitHubat commit 3084578

Compare with similar skills

Vss Observability 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.

Vss Observability compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vss Observability this skillopen-edge-platform/edge-ai-libraries169—~913Automated safety check: PassApache-2.0
Logfire Infrastructurepydantic/skills140—~1.8kAutomated safety check: PassMIT
Alloygrafana/skills279—~1.3kAutomated safety check: PassApache-2.0
Aspire MonitoringCommunityToolkit/Aspire629—~3.5kAutomated safety check: PassMIT
Temps Best Practicesgotempsh/temps826—~2.9kAutomated safety check: PassApache-2.0
Otel Collector Builderollygarden/opentelemetry-agent-skills106—~2kAutomated safety check: PassApache-2.0

Similar skills

  • Logfire Infrastructure

    pydantic/skills

    Official

    Monitor hosts, Docker containers, Kubernetes clusters, database/queue/cache servers, and cloud-provider metrics with Pydantic Logfire — no application code required.

    140 GitHub stars~1.8k tokensUpdated 7 days ago
    DevOps & CloudAuto-check passed
  • Alloy

    grafana/skills

    Official

    Build a unified telemetry pipeline with Grafana Alloy — one OpenTelemetry-compatible binary that collects metrics, logs, traces, and profiles and ships to Grafana Cloud / Prometheus / Loki / Tempo /…

    279 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Aspire Monitoring

    CommunityToolkit/Aspire

    ANALYSIS SKILL - Observe Aspire apps: logs, traces, metrics, resource state, telemetry export, browser telemetry, and the standalone dashboard.

    629 GitHub stars~3.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Temps Best Practices

    gotempsh/temps

    Best-practices reference for preparing and instrumenting applications on Temps.

    826 GitHub stars~2.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Otel Collector Builder

    ollygarden/opentelemetry-agent-skills

    Build custom OpenTelemetry Collector distributions with OCB (OpenTelemetry Collector Builder).

    106 GitHub stars~2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Official

    Investigate Kubernetes workload, node, and control-plane issues using OTel telemetry (EDOT).

    592 GitHub stars~8.3k tokensUpdated today
    DevOps & CloudAuto-check passed

More from open-edge-platform/edge-ai-libraries

All 29 skills in this repo
  • Time Series Analytics User

    open-edge-platform/edge-ai-libraries

    Build a new time-series analytics use case on top of the deployed Time Series Analytics microservice — bring it up with Docker Compose (from a repo clone, or by fetching the compose files from…

    169 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Vss Add Nest Module

    open-edge-platform/edge-ai-libraries

    Scaffolds and wires a new NestJS service/module for the Video Search & Summarization sample app's pipeline-manager using the repo's real conventions.

    169 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Chatqna Helm Deploy

    open-edge-platform/edge-ai-libraries

    Deploy Chat Question-and-Answer Core to Kubernetes using Helm (OpenVINO CPU, OpenVINO GPU, or Ollama), including values.yaml configuration, helm install/upgrade, deployment verification, uninstall…

    169 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Generate Changelog

    open-edge-platform/edge-ai-libraries

    Generates or updates CHANGELOG.md by analyzing git commit history between two branches, tags, or revisions in ANY git repository or folder.

    169 GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Vss Deploy

    open-edge-platform/edge-ai-libraries

    Deploys and manages VSS through setup.sh and its Docker Compose overlays.

    169 GitHub stars~4.1k tokensUpdated today
    Auto-check passed
  • Vss Deploy Helm

    open-edge-platform/edge-ai-libraries

    A skill your agent uses whenever a developer needs to deploy VSS to Kubernetes, helm install VSS, configure values.yaml for VSS, or run VSS on k8s with GPU/vLLM for the…

    169 GitHub stars~3.8k tokensUpdated today
    Auto-check passed

Categories

Questions about Vss Observability

What does Vss Observability do?

A skill your agent uses for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting. Vss Observability is an agent skill from open-edge-platform/edge-ai-libraries. Use this skill for VSS live metrics, OpenTelemetry traces, pipeline bottlenecks, and metrics-panel troubleshooting.

When should I use Vss Observability?

Vss Observability fits situations like: VSS live metrics; openTelemetry traces; pipeline bottlenecks; metrics-panel troubleshooting.

How do I install Vss Observability in Claude Code?

Run `npx skills add open-edge-platform/edge-ai-libraries --skill vss-observability -a claude-code`. Or copy the skill folder (sample-applications/video-search-and-summarization/.github/skills/vss-observability in open-edge-platform/edge-ai-libraries) into .claude/skills/vss-observability in your project. Claude Code loads it when a task matches its description.

How do I install Vss Observability in Codex?

Run `npx skills add open-edge-platform/edge-ai-libraries --skill vss-observability -a codex`. Or copy the skill folder (sample-applications/video-search-and-summarization/.github/skills/vss-observability in open-edge-platform/edge-ai-libraries) into .agents/skills/vss-observability in your project. Codex loads it when a task matches its description.

Can I use Vss Observability 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 open-edge-platform/edge-ai-libraries --skill vss-observability -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vss-observability, .gemini/skills/vss-observability, .github/skills/vss-observability and .opencode/skills/vss-observability in your project.

What does Vss Observability need to run?

Going by SKILL.md and its folder, Vss Observability needs a shell for the scripts in its folder and the command-line tools its instructions call (curl and bash). Our summary lists: A Bash shell; Docker.

Does Vss Observability access the network?

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

Is Vss Observability 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Vss Observability use?

Vss Observability 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 Vss Observability use?

About 913 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 710 tokens, read only when the agent opens those files.

What are the alternatives to Vss Observability?

Skills that share tags, products or a category with Vss Observability: Logfire Infrastructure (pydantic/skills, 140 stars), Alloy (grafana/skills, 279 stars), Aspire Monitoring (CommunityToolkit/Aspire, 629 stars) and Temps Best Practices (gotempsh/temps, 826 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vss Observability?

open-edge-platform (a GitHub organization) maintains it in open-edge-platform/edge-ai-libraries, which has 169 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 8, 2026.

Source: open-edge-platform/edge-ai-libraries on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.