Agent skill

Run Tests

by spiriMirror in spiriMirror/libuipc

“Run C++ and Python tests”

— description from SKILL.md by spiriMirror
Apache-2.0Auto-check passedTesting & QA

Install Run Tests

skills CLI
$ npx skills add spiriMirror/libuipc --skill run-tests -a claude-code

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

GitHub CLI
$ gh skill install spiriMirror/libuipc run-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/spiriMirror/libuipc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/run-tests .claude/skills/run-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-tests
GitHub stars
335
Token cost
~485 tokens
SKILL.md length
185 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

  • SKILL.md covers Overview, Prerequisites, Run All Tests in a Binary and Run a Specific Test Case, plus 5 more sections
  • Calls uv and pytest

About this skill

Run Tests is a skill in spiriMirror/libuipc (335 stars). Its SKILL.md is about 485 tokens. Licence: Apache-2.0.

What it can do on your machine

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

    • uv
    • pytest

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

  • Network

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

Run Tests loads about 485 tokens when it runs. Until then it costs about 9 tokens; SKILL.md has 185 words of instructions outside code blocks.

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

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 spiriMirror/libuipc at commit 9c748a7, republished under its Apache-2.0 licence (© spiriMirror). 185 words, ~485 tokens.

Download SKILL.mdSave it as .claude/skills/run-tests/SKILL.md (or your agent's skills folder).
name
run-tests
description
Run C++ and Python tests
disable-model-invocation
true

Run Tests

Overview

Run C++ tests built with Catch2. Test sources are in apps/tests/, grouped by feature area.

Prerequisites

Build the project first using the build command. Test binaries are output to <cmake-binary-directory>/<configuration>/bin/.

Run All Tests in a Binary

bash
cd <cmake-binary-directory>/<configuration>/bin
./uipc_test_<name>

Test binary names follow the pattern uipc_test_<name> where <name> matches the CMake target name in apps/tests/. On Windows, the executable will have an .exe extension.

Run a Specific Test Case

bash
./uipc_test_<name> "<test-case-name>"

Run Tests Matching a Tag

Catch2 tags are used to group tests (e.g., [geometry], [core]):

bash
./uipc_test_<name> '[geometry]'

Adjust Log Level

bash
./uipc_test_<name> --log-level <level>

Levels: trace, debug, info, warn, error, critical, off.

List Available Tests

bash
./uipc_test_<name> --list-tests

Python tests (pytest)

Python tests live under python/tests/. Run them with the project venv after installing pyuipc (e.g. uv pip install -e . or a CMake build that installs into the venv).

To avoid uv re-syncing (and rebuilding) the project every time, use --no-sync:

bash
uv run --no-sync pytest python/tests

Or run pytest from the venv directly:

bash
.venv/bin/pytest python/tests

Without --no-sync, uv run syncs the environment first, which (re)builds and installs pyuipc from source.

Test Organization

DirectoryArea
apps/tests/geometry/Geometry algorithms
apps/tests/core/Core engine
apps/tests/common/Common utilities
apps/tests/backends/Backend tests
apps/tests/sim_case/Simulation cases
apps/tests/sanity_check/Sanity checks

© spiriMirror, 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 .cursor/skills/run-tests of spiriMirror/libuipc.

Open the folder on GitHubat commit 9c748a7

Compare with similar skills

Run 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 Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Tests this skillspiriMirror/libuipc335—~485Automated safety check: PassApache-2.0
Run Integration Testsvalkey-io/valkey-search145—~511Automated safety check: PassBSD-3-Clause
TDD2SSK/dot-files247—~444Automated safety check: PassMIT
Generating Python Installeraffaan-m/ECC275k1 repos~6.1kAutomated safety check: PassMIT
Review Op Test CoverageCVCUDA/CV-CUDA2.7k—~264Automated safety check: PassCustom licence
Test Case ReducerArabelaTso/Skills-4-SE253—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Run Integration Tests

    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.

    145 GitHub stars~511 tokensUpdated today
    Testing & QAAuto-check passed
  • TDD

    2SSK/dot-files

    Test-Driven Development workflow. An agent skill from 2SSK/dot-files.

    247 GitHub stars~444 tokensUpdated 26 days ago
    Testing & QAAuto-check passed
  • Commercial-grade Python installer expert for Windows: Nuitka extreme compilation, dist slimming, DLL footprint analysis, and Inno Setup packaging to ship the smallest, fastest installers.

    275k GitHub starsUsed in 1 repo~6.1k tokens
    Testing & QAAuto-check passed
  • Review a CV-CUDA operator's test coverage, including C++ correctness, required cross-layout parity, correctness rigor, and the Python API surface.

    2.7k GitHub stars~264 tokensUpdated 21 days ago
    Testing & QAAuto-check passed
  • 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
  • Symbolic Execution Assistant

    ArabelaTso/Skills-4-SE

    Performs symbolic execution to detect potential errors by exploring execution paths, solving path constraints, and generating test inputs.

    253 GitHub stars~3.5k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

More from spiriMirror/libuipc

All 16 skills in this repo
  • GPU Optimization

    spiriMirror/libuipc

    GPU optimization workflow using uipc.profile, uipc.profile.nsight, and Nsight Compute CLI.

    335 GitHub stars~3.6k tokensUpdated 5 days ago
    Auto-check passed
  • Review PR

    spiriMirror/libuipc

    Review a libuipc pull request end-to-end: checkout the PR, summarize changes, list files for the human reviewer, and perform a domain-aware AI review covering physics correctness, backend…

    335 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Xmake Workflow

    spiriMirror/libuipc

    Build and test the libuipc project using XMake. An agent skill from spiriMirror/libuipc.

    335 GitHub stars~588 tokensUpdated 5 days ago
    Auto-check passed
  • Cmake Workflow

    spiriMirror/libuipc

    Build and test the libuipc project using CMake. An agent skill from spiriMirror/libuipc.

    335 GitHub stars~321 tokensUpdated 5 days ago
    Auto-check passed
  • Document

    spiriMirror/libuipc

    Documentation style guide and rules for creating documentation

    335 GitHub stars~930 tokensUpdated 5 days ago
    Auto-check passed
  • Fix Issue

    spiriMirror/libuipc

    Fix a GitHub issue with proper branch, testing, and PR workflow

    335 GitHub stars~421 tokensUpdated 5 days ago
    Auto-check passed

Works with

Categories

Questions about Run Tests

How do I install Run Tests in Claude Code?

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

How do I install Run Tests in Codex?

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

Can I use Run 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 spiriMirror/libuipc --skill run-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-tests, .gemini/skills/run-tests, .github/skills/run-tests and .opencode/skills/run-tests in your project.

What does Run Tests need to run?

Going by SKILL.md and its folder, Run Tests needs the command-line tools its instructions call (uv and pytest).

Does Run Tests access the network?

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

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

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

About 485 tokens (SKILL.md is roughly 1.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 Run Tests?

Skills that share tags, products or a category with Run Tests: Run Integration Tests (valkey-io/valkey-search, 145 stars), TDD (2SSK/dot-files, 247 stars), Generating Python Installer (affaan-m/ECC, 275k stars) and Review Op Test Coverage (CVCUDA/CV-CUDA, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Tests?

spiriMirror (a GitHub organization) maintains it in spiriMirror/libuipc, which has 335 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 3, 2026.

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