Agent skill

Run Integration Tests

by valkey-io in valkey-io/valkey-search

Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification.

BSD-3-ClauseAuto-check passedTesting & QA

Install Run Integration Tests

skills CLI
$ npx skills add valkey-io/valkey-search --skill run-integration-tests -a claude-code

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

GitHub CLI
$ gh skill install valkey-io/valkey-search run-integration-tests --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/valkey-io/valkey-search.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/run-integration-tests .claude/skills/run-integration-tests && 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
run-integration-tests
GitHub stars
145
Token cost
~511 tokens
SKILL.md length
184 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification.

  • Works in 3 steps: Check the build prerequisites. If CMake… → During development, run the smallest… → Before opening or updating a PR, run the…
  • Tasks that involve Integration testing
  • SKILL.md covers Common Steps and Failure Reporting
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Run Integration Tests is an agent skill from valkey-io/valkey-search. Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification.

Its SKILL.md is about 510 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA, covering Integration testing and Vector databases. It works with C++ and Python. The repository describes itself as: valkey-search is a C++ module which extends valkey with vector search and secondary indexing capabilities. It enables users to index and query data stored in Valkey using complex… The licence is BSD-3-Clause.

When your agent uses it

  • Tasks that involve Integration testing
  • Tasks that involve Vector databases

Example prompts

  • “/run-integration-tests”

Requirements

  • Python 3

Workflow steps

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

  1. Check the build prerequisites. If CMake reports a missing dependency from
  2. During development, run the smallest focused test that exercises the
  3. Before opening or updating a PR, run the full integration suite through the

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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

Run Integration Tests loads about 511 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 184 words of instructions outside code blocks.

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

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 valkey-io/valkey-search at commit 8fa0d7a, republished under its BSD-3-Clause licence (© valkey-io). 184 words, ~511 tokens.

Download SKILL.mdSave it as .claude/skills/run-integration-tests/SKILL.md (or your agent's skills folder).
name
run-integration-tests
description
Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification.

Run Integration Tests

Run and diagnose the Valkey Search integration suites. The repository has two top-level integration harnesses:

  • Abseil/C++ harness under testing/integration/. It runs the vector_search_integration and stability suites through testing/integration/run.sh.
  • OSS Python harness under integration/. It runs pytest tests through the Valkey test framework. Its test cases cover standalone command mode (CMD) and cluster/coordinator mode (CME).

Common Steps

  1. Check the build prerequisites. If CMake reports a missing dependency from /opt/valkey-search-deps, bootstrap with:

    bash
    .devcontainer/run_in_docker.sh ./build.sh --no-system-modules --debug

    Use --no-system-modules again only after cleaning or reconfiguring an incomplete build. Classify missing dependencies in newly generated repository-owned bundles as packaging/build failures; classify stale or externally misconfigured dependencies as environment failures.

  2. During development, run the smallest focused test that exercises the changed path. Inspect the available selectors with:

    bash
    ./build.sh --help
    testing/integration/run.sh --help

    Use build.sh --run-integration-tests=<pattern> for Python tests or testing/integration/run.sh --test <suite> for C++ suite selection.

  3. Before opening or updating a PR, run the full integration suite through the devcontainer:

    bash
    .devcontainer/run_in_docker.sh ./build.sh --run-integration-tests --debug

    Do not run integration servers directly on the host.

Failure Reporting

Report the command, selector, harness, mode, and relevant logs. Classify the result as a product, packaging/build, harness, cluster-readiness/timing, or environment failure.

© valkey-io, BSD-3-Clause. 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/run-integration-tests of valkey-io/valkey-search.

Open the folder on GitHubat commit 8fa0d7a

Compare with similar skills

Run Integration Tests 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.

Run Integration Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Integration Tests this skillvalkey-io/valkey-search145—~511Automated safety check: PassBSD-3-Clause
Test Case ReducerArabelaTso/Skills-4-SE253—~2.5kAutomated safety check: PassApache-2.0
Fory Version Bumpapache/fory4.6k—~1.1kAutomated safety check: PassApache-2.0
OpenHarness End-to-End EvalsHKUDS/OpenHarness16k1 repos~2.1kAutomated safety check: NotesMIT
Create Flet Control Integration Testsflet-dev/flet17k—~1.4kAutomated safety check: PassApache-2.0
OpenROAD Module Test AdderThe-OpenROAD-Project/OpenROAD3.2k—~1.8kAutomated safety check: PassBSD-3-Clause

Similar skills

  • Test Case Reducer

    ArabelaTso/Skills-4-SE

    Automatically reduces bug-triggering test cases to minimal form while preserving the failure.

    253 GitHub stars~2.5k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Bump Apache Fory release or post-release development versions across Java, Kotlin, Scala, Python, Rust, Go, C++, C, Dart, JavaScript, Swift, integration tests, examples, and source docs.

    4.6k GitHub stars~1.1k tokensUpdated today
    MobileAuto-check passed
  • Validates OpenHarness features by running real multi-turn agent loops with live LLM calls against an unfamiliar codebase, checking actual tool execution.

    16k GitHub starsUsed in 1 repo~2.1k tokens
    Testing & QAAuto-check: notes
  • A skill your agent uses when asked to create or update integration tests for any Flet control in sdk/python/packages/flet/integrationtests, including visual goldens and interactive behavior tests.

    17k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • OpenROAD Module Test Adder

    The-OpenROAD-Project/OpenROAD

    Adds integration or unit tests to an OpenROAD module: writes the Tcl test, generates golden files and registers it in both CMake and Bazel.

    3.2k GitHub stars~1.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Godot E2E

    RandallLiuXin/GodotMaker

    Write and run E2E (end-to-end) game tests using the godot-e2e framework.

    549 GitHub starsUsed in 1 repo~3.9k tokens
    Testing & QAAuto-check passed

More from valkey-io/valkey-search

  • Stale PRs

    valkey-io/valkey-search

    Find open valkey-search pull requests that have not been updated in more than 30 days.

    145 GitHub stars~283 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Run Integration Tests

What does Run Integration Tests do?

Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification. Run Integration Tests is an agent skill from valkey-io/valkey-search. Run or troubleshoot Valkey Search C++ and Python integration tests, including focused development runs, full-suite verification, and packaging/build or runtime failure classification.

When should I use Run Integration Tests?

Run Integration Tests fits situations like: tasks that involve Integration testing; tasks that involve Vector databases.

How do I install Run Integration Tests in Claude Code?

Run `npx skills add valkey-io/valkey-search --skill run-integration-tests -a claude-code`. Or copy the skill folder (.agents/skills/run-integration-tests in valkey-io/valkey-search) into .claude/skills/run-integration-tests in your project. Claude Code loads it when a task matches its description.

How do I install Run Integration Tests in Codex?

Run `npx skills add valkey-io/valkey-search --skill run-integration-tests -a codex`. Or copy the skill folder (.agents/skills/run-integration-tests in valkey-io/valkey-search) into .agents/skills/run-integration-tests in your project. Codex loads it when a task matches its description.

Can I use Run Integration Tests 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 valkey-io/valkey-search --skill run-integration-tests -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-integration-tests, .gemini/skills/run-integration-tests, .github/skills/run-integration-tests and .opencode/skills/run-integration-tests in your project.

What does Run Integration Tests need to run?

SKILL.md names no scripts, command-line tools or credentials: Run Integration Tests is instructions for the agent only. Our summary lists: Python 3.

Does Run Integration Tests access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run Integration Tests 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 Run Integration Tests use?

Run Integration Tests is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Integration Tests use?

About 511 tokens (SKILL.md is roughly 2k 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 Run Integration Tests?

Skills that share tags, products or a category with Run Integration Tests: Test Case Reducer (ArabelaTso/Skills-4-SE, 253 stars), Fory Version Bump (apache/fory, 4.6k stars), OpenHarness End-to-End Evals (HKUDS/OpenHarness, 16k stars) and Create Flet Control Integration Tests (flet-dev/flet, 17k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Integration Tests?

valkey-io (a GitHub organization) maintains it in valkey-io/valkey-search, which has 145 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 7, 2026.

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