Build (and optionally push) the VSS Docker images from source with make build, make build-deps, and make push - the application services, the dependency microservices, or both, with registry/tag…

Apache-2.0Auto-check: notesBackend & APIs

Install Vss Build

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

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

GitHub CLI
$ gh skill install open-edge-platform/edge-ai-libraries vss-build --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-build .claude/skills/vss-build && 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-build
GitHub stars
169
Token cost
~1.9k tokens
SKILL.md length
690 words
Files
12 (incl. scripts)
Skills in repo
29
Repo updated
First seen
Licence
Apache-2.0

At a glance

Build (and optionally push) the VSS Docker images from source with make build, make build-deps, and make push - the application services, the dependency microservices, or both, with registry/tag…

  • Works in 3 steps: make build TAG=dev REGISTRY_URL=... -… → Exported shell variables (export TAG=dev). → .env at the app root, which the Makefile…
  • The user says build vss
  • SKILL.md covers Environment setup (run first), What the build targets do, Controls (registry, tag,… and make build-deps needs the…, plus 3 more sections
  • Runs Shell scripts from its folder; calls make, git and bash

What it does

Vss Build is an agent skill from open-edge-platform/edge-ai-libraries. Build (and optionally push) the VSS Docker images from source with make build, make build-deps, and make push - the application services, the dependency microservices, or both, with registry/tag, proxy, and copyleft controls. Use when the user says "build vss", "rebuild the images", "build from source", "build the dependencies", or "push the vss images". The Makefile is the source of truth for builds; there is no build.sh at the app root.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts (for example `BENCHMARK.md`, `evals/evals.json` and `example-prompts/01-local-app-rebuild.md`).

It sits in Backend & APIs, covering Microservices, Regulatory compliance and Containers. It works with Docker. 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

  • The user says build vss
  • Rebuild the images
  • Build from source
  • Build the dependencies

Example prompts

  • “build vss”
  • “rebuild the images”
  • “build from source”
  • “/vss-build”

Requirements

  • A Bash shell
  • Docker

Workflow steps

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

  1. make build TAG=dev REGISTRY_URL=... - command-line variables win over everything.
  2. Exported shell variables (export TAG=dev).
  3. .env at the app root, which the Makefile reads at parse time. It is

What it can do on your machine

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

    • make
    • git
    • bash
    • docker

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

  • Network

    No URLs in SKILL.md. Its commands use git and docker, 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 Build loads about 1.9k tokens when it runs. Until then it costs about 115 tokens; SKILL.md has 690 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:77
    prefix (one trailing `/` normalised) | `.env` value, shipped as `intel/` |
  • NoteMentions a .env fileSKILL.md:78
    /namespace segment after the registry | `.env` value, shipped empty |
  • NoteMentions a .env fileSKILL.md:80
    | `TAG` | image tag | `.env` value, else `latest` |
  • NoteMentions a .env fileSKILL.md:90
    3. `.env` at the app root, which the Makefile reads at parse time. It is

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 cdf860c, republished under its Apache-2.0 licence (© open-edge-platform). 690 words, ~1,859 tokens.

Download SKILL.mdSave it as .claude/skills/vss-build/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
vss-build
description
Build (and optionally push) the VSS Docker images from source with `make build`, `make build-deps`, and `make push` - the application services, the dependency microservices, or both, with registry/tag, proxy, and copyleft controls. Use when the user says "build vss", "rebuild the images", "build from source", "build the dependencies", or "push the vss images". The Makefile is the source of truth for builds; there is no build.sh at the app root.
license
Apache-2.0
metadata.version
2.0.0
metadata.tags
vss build development
<!--
SPDX-FileCopyrightText: (C) 2026 Intel Corporation
SPDX-License-Identifier: Apache-2.0
-->

VSS Build

Build VSS container images with the Makefile - the source of truth for builds in this repo. There is no build.sh at the app root; the only build.sh scripts left are upstream ones inside microservices/, which make build-deps calls for you. Run the commands yourself and relay output.

The canonical human-readable guide is docs/user-guide/build-from-source.md; keep answers consistent with it and with the Makefile itself.

Environment setup (run first)

This skill drives the Video Search & Summarization app through its real source files, so the VSS application must be present and you must run commands from its app root. Do this before anything else, and it works whether or not the VSS source is already in your workspace.

Run the bundled bootstrap. It first tries to find an existing VSS checkout - walking up from the current directory and inspecting the enclosing git repo - and reuses it without ever re-cloning. Only when no checkout is found does it do a shallow, single-branch, sparse checkout of just sample-applications/video-search-and-summarization from main. It prints the resolved app root on stdout:

bash
# SKILL_DIR is THIS skill's own directory (shown to you when the skill loads);
# in-repo it is .github/skills/vss-build. Works the same if the skill is installed standalone.
SKILL_DIR=".github/skills/vss-build"
APP_ROOT="$(bash "$SKILL_DIR/scripts/vss-bootstrap.sh")"
cd "$APP_ROOT"

Every command below assumes the working directory is this APP_ROOT (the Makefile lives there). To pull from a fork/branch or reuse a specific checkout dir, override VSS_REPO_URL, VSS_REPO_BRANCH, or VSS_CLONE_DIR before running it.

What the build targets do

CommandBuilds
make buildApplication services: pipeline-manager, vss-ui, video-search (from search-ms/), video-ingestion
make build-depsDependency microservices: multimodal-dataprep, multimodal-embedding-serving, and vector-retriever-vdms + vector-retriever-milvus (one image per backend)
make pushPush every app and dependency image to the configured registry
make listPrint the resolved tag, registry prefix, and the exact image names - use it to confirm config before building
make cleanRemove the locally built application images (not the dependency ones)
make helpAll targets, including test/scan/deploy

Run make build-deps the first time, or when those upstream microservices changed; otherwise plain make build is enough for day-to-day app changes. Order between the two does not matter - they are independent.

The make deploy-* targets already declare build build-deps as prerequisites, so a deploy through vss-deploy's Makefile path rebuilds first; a separate build is only needed when you want images without deploying.

Show full SKILL.md (339 more words)Show less

Controls (registry, tag, proxy, copyleft)

VarEffectDefault
REGISTRY_URLregistry host prefix (one trailing / normalised).env value, shipped as intel/
PROJECT_NAMEproject/namespace segment after the registry.env value, shipped empty
REGISTRYthe whole prefix at once; overrides the two above$(REGISTRY_URL)$(PROJECT_NAME)
TAGimage tag.env value, else latest
http_proxy / https_proxy / no_proxypassed through as Docker --build-args; omitted entirely when unsetinherited
ADD_COPYLEFT_SOURCES=truebuilds with --build-arg COPYLEFT_SOURCES=trueunset

Every image is named <REGISTRY_URL><PROJECT_NAME>/<service>:<TAG>.

Where the values come from, highest precedence first:

  1. make build TAG=dev REGISTRY_URL=... - command-line variables win over everything.
  2. Exported shell variables (export TAG=dev).
  3. .env at the app root, which the Makefile reads at parse time. It is auto-created from .env.example on the first make build / build-deps / push, so with no overrides you get the shipped intel/ prefix - not bare local names.

To build genuinely un-prefixed local images, clear the prefix explicitly:

bash
make build REGISTRY_URL= PROJECT_NAME=      # → pipeline-manager:latest, …

Build and deploy must agree: setup.sh composes REGISTRY from REGISTRY_URL/PROJECT_NAME the same way, so Compose only finds your images if the prefix and TAG match what you built. See vss-deploy/vss.config (REGISTRY_URL, TAG) and keep the two in sync.

make build-deps needs the sibling microservices/ tree

build-deps reaches out to ../../microservices for the dataprep, embedding-serving, and vector-retriever sources, and fails fast if they are missing. A bootstrap clone is sparse - it contains only sample-applications/video-search-and-summarization - so widen it before building dependencies:

bash
[ -d ../../microservices ] || \
  git -C "$(git rev-parse --show-toplevel)" sparse-checkout add microservices

No-op in a full clone (the directory is already there). make build alone does not need this.

Typical flows

bash
# Local app rebuild, then deploy:
make build
#   ! export VSS_CREDENTIALS_FILE="${XDG_CONFIG_HOME:-$HOME/.config}/vss/vss.credentials" && ./.github/skills/vss-deploy/scripts/gen-secrets.sh && source .github/skills/vss-deploy/vss.config && source "$VSS_CREDENTIALS_FILE" && source setup.sh --summary

# First-time / dependency refresh:
make build-deps && make build

# Build for a registry and push:
make build build-deps push REGISTRY_URL=registry.example.com PROJECT_NAME=vss-team TAG=v0.9.2

# Compliance build with copyleft sources, no push:
make build-deps build ADD_COPYLEFT_SOURCES=true TAG=compliance-2026-07

Prerequisites & gotchas

  • Docker and make required. Poetry is not needed on the host - the embedding-serving image installs it inside the build.
  • make push refuses to run with an empty prefix rather than pushing un-namespaced images to docker.io; set REGISTRY_URL(+PROJECT_NAME) or REGISTRY. It skips images that are not present locally, so build first.
  • Behind a corporate proxy, export http_proxy/https_proxy/no_proxy before building so they reach the image builds as build args.
  • make clean only removes the four application images; dependency images stay.
  • After building locally, deploy with vss-deploy; setup.sh uses the images you just built (match TAG/REGISTRY_URL).

Verify

bash
make list      # expected image names for the current config
docker images | grep -E 'pipeline-manager|vss-ui|video-search|video-ingestion|multimodal-|vector-retriever'

© 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 11 other files (scripts) in sample-applications/video-search-and-summarization/.github/skills/vss-build of open-edge-platform/edge-ai-libraries.

  • SKILL.md
  • BENCHMARK.md
  • evals/evals.json
  • example-prompts/01-local-app-rebuild.md
  • example-prompts/02-first-time-with-dependencies.md
  • example-prompts/03-registry-tag-push.md
  • example-prompts/04-corporate-proxy-build.md
  • example-prompts/05-fresh-checkout-bootstrap.md
  • example-prompts/06-copyleft-sources-build.md
  • example-prompts/07-bootstrap-fresh-machine.md
  • example-prompts/README.md
  • scripts/vss-bootstrap.sh

Open the folder on GitHubat commit cdf860c

Compare with similar skills

Vss Build 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 Build compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vss Build this skillopen-edge-platform/edge-ai-libraries169—~1.9kAutomated safety check: NotesApache-2.0
Dr Jskilljdubois/dr-jskill342—~4.6kAutomated safety check: NotesApache-2.0
Polylith Project ManagementDavidVujic/python-polylith553—~1.5kAutomated safety check: PassMIT
Spring Boot Project Creatorgiuseppe-trisciuoglio/developer-kit356—~3.4kAutomated safety check: NotesMIT
Frontmcp Deploymentagentfront/frontmcp146—~9.2kAutomated safety check: NotesApache-2.0
Evo2 NimNVIDIA/skills3.5k1 repos~2.4kAutomated safety check: NotesApache-2.0

Similar skills

  • Dr Jskill

    jdubois/dr-jskill

    Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker.

    342 GitHub stars~4.6k tokensUpdated 9 days ago
    Backend & APIsAuto-check: notes
  • Polylith Project Management

    DavidVujic/python-polylith

    Create a deployable Polylith project with poly create project — a lightweight pyproject.toml under projects/<name/ that references bricks for deployment as a Docker image, wheel, AWS Lambda, GCP…

    553 GitHub stars~1.5k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Spring Boot Project Creator

    giuseppe-trisciuoglio/developer-kit

    Creates and scaffolds a new Spring Boot project (3.x or 4.x) by downloading from Spring Initializr, generating package structure (DDD or Layered architecture), configuring JPA, SpringDoc OpenAPI…

    356 GitHub stars~3.4k tokensUpdated 29 days ago
    Backend & APIsAuto-check: notes
  • Frontmcp Deployment

    agentfront/frontmcp

    A skill your agent uses when deploying, building for production, packaging, or shipping a FrontMCP server.

    146 GitHub stars~9.2k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Evo2 Nim

    NVIDIA/skills

    Official

    Generate and analyze DNA sequences using NVIDIA's Evo 2 BioNeMo NIM microservice.

    3.5k GitHub starsUsed in 1 repo~2.4k tokens
    DevOps & CloudAuto-check: notes
  • Genmol Nim

    NVIDIA/skills

    Official

    Generate novel drug-like molecules using the GenMol NIM microservice.

    3.5k GitHub starsUsed in 1 repo~1.4k tokens
    DevOps & CloudAuto-check: notes

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

Works with

Categories

Questions about Vss Build

What does Vss Build do?

Build (and optionally push) the VSS Docker images from source with make build, make build-deps, and make push - the application services, the dependency microservices, or both, with registry/tag…. Vss Build is an agent skill from open-edge-platform/edge-ai-libraries. Build (and optionally push) the VSS Docker images from source with make build, make build-deps, and make push - the application services, the dependency microservices, or both, with registry/tag, proxy, and copyleft controls.

When should I use Vss Build?

Vss Build fits situations like: the user says build vss; rebuild the images; build from source; build the dependencies.

How do I install Vss Build in Claude Code?

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

How do I install Vss Build in Codex?

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

Can I use Vss Build 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-build -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-build, .gemini/skills/vss-build, .github/skills/vss-build and .opencode/skills/vss-build in your project.

What does Vss Build need to run?

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

Does Vss Build access the network?

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

Is Vss Build safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Build use?

Vss Build is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vss Build use?

About 1.9k tokens (SKILL.md is roughly 7.4k 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 Vss Build?

Skills that share tags, products or a category with Vss Build: Dr Jskill (jdubois/dr-jskill, 342 stars), Polylith Project Management (DavidVujic/python-polylith, 553 stars), Spring Boot Project Creator (giuseppe-trisciuoglio/developer-kit, 356 stars) and Frontmcp Deployment (agentfront/frontmcp, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vss Build?

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 9, 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.