test-locally

test-locally is a skill for Claude Code, Codex from open-metadata/OpenMetadata. It costs 38 tokens per session (1,395 once invoked), scanned A, original, Apache-2.0.

A process for running a complete local OpenMetadata installation with Docker, a tool that runs applications in isolated containers. It builds and starts the stack, checks its health, and supports testing a connector through the interface.

In plain words
What is it for?
Use it when you need to test locally, start or stop the Docker stack, deploy changes, or test a connector in the OpenMetadata interface. It can adjust the build based on what changed.
Why use it?
It gives developers a way to test connector changes in an environment resembling the full application instead of checking only isolated code.

Skill for Claude CodeCodex

Part of the openmetadata-skills plugin — 20 skills, 5 commands, 6 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/open-metadata/openmetadata/test-locally
Any agent
npx skills add open-metadata/OpenMetadata --skill test-locally
Clone the repo
git clone --depth 1 https://github.com/open-metadata/OpenMetadata

Made for: Claude Code, Codex.

Or install openmetadata-skills, the plugin that ships this one along with the rest of its 20 skills, 5 commands, 6 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for test-locally

README.md
[![agentmods](https://agentmods.dev/badge/skills/open-metadata/openmetadata/test-locally.svg)](https://agentmods.dev/skills/open-metadata/openmetadata/test-locally)
Your own site
<a href="https://agentmods.dev/skills/open-metadata/openmetadata/test-locally"><img src="https://agentmods.dev/badge/skills/open-metadata/openmetadata/test-locally.svg" alt="Measured on agentmods" height="20"></a>
Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,395 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00038 $0.01395
Opus 5 $0.00019 $0.00698
Sonnet 5 $0.00008 $0.00279
Haiku 4.5 $0.00004 $0.00139

Measured 4d ago against content hash fe9b26629757, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

test-locally scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -s -o /dev/null -w "%{http_code}" http://localhost:8585/api/v1/system/version
skills/test-locally/SKILL.md · 201 lines

How it starts

The opening of the file, as written. The whole thing — 201 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Test Connector Locally

Build, deploy, and test a connector in a full local OpenMetadata stack with Docker.

When to Activate

When a user asks to "test locally", "start docker", "deploy locally", "test in the UI", "bring up the stack", or "run local docker".

Arguments

  • --skip-maven or --fast: Skip the Maven build (use when only ingestion Python code changed)
  • --rebuild: Tear down existing containers and rebuild
  • --teardown or --down: Just stop and remove containers
  • No arguments: Auto-detect what changed and choose the optimal build strategy

Process

Step 0: Handle Teardown

If the user asked to tear down / stop:

cd docker/development && docker compose down -v

Report success and exit.

Step 1: Check Prerequisites

Verify the environment is ready:

# Check Docker is running
docker info > /dev/null 2>&1 || echo "Docker is not running"

# Check docker compose is available
docker compose version > /dev/null 2>&1 || echo "docker compose not found"

# Check we're in the repo root
test -f docker/run_local_docker.sh || echo "Not in OpenMetadata repo root"

If any check fails, tell the user what to fix and stop.

Step 2: Activate Environment

source env/bin/activate

Step 3: Run Code Generation

Always run code generation to ensure models are up to date:

make generate

If make generate fails, check if the venv is set up:

make install_dev generate

Step 4: Detect Build Strategy

Decide whether to skip the Maven build. Check what files changed:

# Check for Java/schema/UI changes since last build
git diff --name-only HEAD~5 | grep -E "^(openmetadata-spec|openmetadata-service|openmetadata-ui)" | head -5

Skip Maven if:

  • User passed --skip-maven or --fast
  • Only files under ingestion/ changed (Python-only changes)
  • No changes to openmetadata-spec/, openmetadata-service/, or openmetadata-ui/

Full build if:

  • JSON Schema files changed (openmetadata-spec/)
  • Java service code changed (openmetadata-service/)
  • UI code changed (openmetadata-ui/)
  • First time running (no existing Docker images)
  • User explicitly asked for full build

Read the full file on GitHub · 201 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 201 lines · 38 tokens per session scan A fe9b26629757

Subscribe to this mod's changes

test-locally is a skill published in the GitHub repository open-metadata/OpenMetadata (15,098 stars, last pushed today), licensed Apache-2.0. It adds 38 tokens to every session and 1,395 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

test-review

You are an expert DataHub test reviewer. Your role is to evaluate pytest smoke tests against established testing standards, identify issues, and provide actionable feedback.

datahub-project/datahub · 0 tokens

oss-fuzz

Run Tika's OSS-Fuzz Jazzer targets locally against a working-tree checkout — build the image, build fuzzers from local source, fuzz a target, run a corpus as a regression pass, reproduce a crash, and add seeds. Use for "fuzz the OneNote parser", "run OneNoteParserFuzzer against these files", "reproduce an OSS-Fuzz…

apache/tika · 90 tokens

update-site-for-release

Update/publish the Apache Tika website (tika-site SVN repo) for a release — step 17 of the Release Process. Handles the 4.x track (Changes page + aggregate javadoc + Antora docs branch) vs the 3.x maintenance track (full per-version apt docs + javadoc). Use for "update the site", "publish the site for X.Y.Z", "the…

apache/tika · 92 tokens

file-to-markdown

Turn almost any file into Markdown plus metadata — PDF, Office, HTML, email, archives, images, audio/video, 1000+ formats — powered by Apache Tika, either via the tika-app CLI (zero setup, one file) or a running tika-server (curl, warm process, many calls). Leads with rmeta (structured, embedded-item-aware output) as…

apache/tika · 147 tokens

development

Ground rules for working in the Tika codebase — git policy, Maven wrapper/repo conventions, building and testing specific modules, code and test conventions, pre-commit checks. Load at session start for any Tika development task.

apache/tika · 49 tokens

tika-eval-compare

Compare extracts from two Tika builds over a corpus to detect regressions in content, encoding, exceptions, and embedded-document handling. Use for "compare before/after extracts", "eval this change against the corpus".

apache/tika · 50 tokens