# run-python-tests

The run-python-tests skill runs end-to-end Python tests after code changes and gathers failure details. Use it after the build and Rust test stages pass.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 6244 repo stars
- Author: RediSearch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/RediSearch/RediSearch/tree/HEAD/.skills/run-python-tests/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/run-python-tests

## What it does

The skill starts Python tests through `./build.sh RUN_PYTEST ENABLE_ASSERT=1`. Its first pass uses `TEST_TIMEOUT=20` for quick feedback. You can target the whole suite, one file, several files, or one test with the `filename:test_name` form.

A failed test produces runner output and a log under `tests/pytests/logs`. The skill then prepares a report with passed, failed, and skipped test counts, Python-side error messages, server stack details, and each log path. Rust panics include the Rust message and backtrace; C crashes include the C backtrace.

Run it after the build and Rust tests have passed. If a quick run times out, related tests can be rerun without `TEST_TIMEOUT`; when relevance is unclear, the skill asks whether to run them again without the limit.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add RediSearch/RediSearch --skill run-python-tests -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/run-python-tests/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/run-python-tests/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add RediSearch/RediSearch --skill run-python-tests -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/run-python-tests/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add RediSearch/RediSearch --skill run-python-tests -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/run-python-tests/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install RediSearch/RediSearch .skills/run-python-tests/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/run-python-tests/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add RediSearch/RediSearch --skill run-python-tests -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/RediSearch/RediSearch --path .skills/run-python-tests
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/run-python-tests/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add RediSearch/RediSearch --skill run-python-tests -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/RediSearch/RediSearch/tree/HEAD/.skills/run-python-tests/SKILL.md

## When to use it
- run the full end-to-end Python suite
- check tests from a selected file
- rerun one test without a timeout
- trace a Redis server failure
- prepare a test result report

## Example prompts
- Run a quick pass of all Python tests after my changes.
- Check `test_query_thread_crash` from `test_crash` without a time limit.
- Run the tests from `test_crash` and `test_gc`, then prepare a failure report.

## Similar
- [python-tests](https://affpapa.org/en/nevibecode/rules/python-tests.md) — rule · ★ 1627 repo stars
- [python-testing-patterns](https://affpapa.org/en/nevibecode/skills/python-testing-patterns.md) — skill · 36943 installs
- [python-testing](https://affpapa.org/en/nevibecode/skills/python-testing.md) — skill · 6800 installs
- [python-tdd-with-uv](https://affpapa.org/en/nevibecode/skills/python-tdd-with-uv.md) — skill · 449 installs
- [python-testing-strategies](https://affpapa.org/en/nevibecode/skills/python-testing-strategies.md) — skill · ★ 111 repo stars
- [playwright-python](https://affpapa.org/en/nevibecode/rules/playwright-python.md) — rule · ★ 41430 repo stars

From the same set: [redisearch/redisearch](https://affpapa.org/en/nevibecode/by/redisearch/redisearch.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
