Agent skill

Manual Test

by hypequery in hypequery/hypequery

Execute one of the model-runnable E2E test specs in testing/ (cli, datasets, serve, mcp, react) against a real ClickHouse instance.

Custom licenceAuto-check passedDatabases

Install Manual Test

skills CLI
$ npx skills add hypequery/hypequery --skill manual-test -a claude-code

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

GitHub CLI
$ gh skill install hypequery/hypequery manual-test --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/hypequery/hypequery.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/manual-test .claude/skills/manual-test && 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
manual-test
GitHub stars
103
Token cost
~618 tokens
SKILL.md length
321 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Custom licence

At a glance

Execute one of the model-runnable E2E test specs in testing/ (cli, datasets, serve, mcp, react) against a real ClickHouse instance.

  • Works in 3 steps: Verify env vars are set: CLICKHOUSE_URL,… → Confirm connectivity with a cheap query… → pnpm build from the repo root so the…
  • Asked to manually test a package
  • SKILL.md covers Arguments, Preflight (do this before…, Rules of engagement and Reporting
  • Calls pnpm; needs CLICKHOUSE_PASSWORD

What it does

Manual Test is an agent skill from hypequery/hypequery. Execute one of the model-runnable E2E test specs in testing/ (cli, datasets, serve, mcp, react) against a real ClickHouse instance. Use when asked to manually test a package, run a testing spec, or verify a package end-to-end against live data.

Its SKILL.md is about 620 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 Databases, covering Data warehousing and End-to-end testing. It works with ClickHouse, Model Context Protocol, React and TypeScript. The repository describes itself as: hypequery - The TypeScript analytics layer for ClickHouse.

When your agent uses it

  • Asked to manually test a package
  • Run a testing spec
  • Verify a package end-to-end against live data

Example prompts

  • “/manual-test”

Workflow steps

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

  1. Verify env vars are set: CLICKHOUSE_URL, CLICKHOUSE_DATABASE, CLICKHOUSE_USERNAME, CLICKHOUSE_PASSWORD. If missing, stop and ask the user…
  2. Confirm connectivity with a cheap query (e.g. SELECT 1 via curl or the client).
  3. pnpm build from the repo root so the packages under test are current.

What it can do on your machine

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

    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, 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 these keys or tokens, usually read from environment variables:

    • CLICKHOUSE_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Manual Test loads about 618 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 321 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 321 words (~618 tokens).

“Execute a spec from testing/ end-to-end. These specs are written to be run by a model, not a script — read the spec fully, then follow its journeys in order.”

— opening of SKILL.md by hypequery, Custom licence
name
manual-test

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/manual-test of hypequery/hypequery.

Open the folder on GitHubat commit 451bf4b

Compare with similar skills

Manual Test 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.

Manual Test compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Manual Test this skillhypequery/hypequery103—~618Automated safety check: PassCustom licence
Testingar-io/ar-io-node127—~2.6kAutomated safety check: NotesAGPL-3.0
Local Platform E2Ecomputesdk/benchmarks126—~3kAutomated safety check: NotesMIT
ClickHouse RowBinary for Node.jsClickHouse/agent-skills544—~1.3kAutomated safety check: PassApache-2.0
Clickhouse Best Practicesvemetric/vemetric3952 repos~2.6kAutomated safety check: PassApache-2.0
Webapp Buildersidequery/sidemantic129—~5.5kAutomated safety check: PassAGPL-3.0

Similar skills

  • Testing

    ar-io/ar-io-node

    Decision guide for testing in the ar-io-node repo — which test layer to use, how to run it, and which helpers to reach for.

    127 GitHub stars~2.6k tokensUpdated today
    Testing & QAAuto-check: notes
  • Local Platform E2E

    computesdk/benchmarks

    Stand up benchmarks-platform locally (Postgres + MinIO + ClickHouse in docker) and run a real @benchsdk/runner benchmark against it, with no cloud or provider credentials.

    126 GitHub stars~3k tokensUpdated today
    DatabasesAuto-check: notes
  • ClickHouse RowBinary for Node.js

    ClickHouse/agent-skills

    Generates TypeScript or JavaScript readers and writers for ClickHouse's RowBinary formats over HTTP in Node.js, after checking that RowBinary suits the data.

    544 GitHub stars~1.3k tokensUpdated 10 days ago
    DatabasesAuto-check passed
  • Clickhouse Best Practices

    vemetric/vemetric

    MUST USE when reviewing ClickHouse schemas, queries, or configurations.

    395 GitHub starsUsed in 2 repos~2.6k tokens
    DatabasesAuto-check passed
  • Webapp Builder

    sidequery/sidemantic

    Build interactive analytics webapps, demos, dashboards, or embedded app surfaces from Sidemantic semantic models using copyable component primitives and deterministic query inspection.

    129 GitHub stars~5.5k tokensUpdated 2 days ago
    DatabasesAuto-check passed
  • Modeler

    sidequery/sidemantic

    Build, validate, and manage semantic models using Sidemantic.

    129 GitHub stars~4.2k tokensUpdated 2 days ago
    DatabasesAuto-check passed

More from hypequery/hypequery

  • Release

    hypequery/hypequery

    Cut a stable hypequery release via Changesets, or explain/check the canary flow.

    103 GitHub stars~623 tokensUpdated today
    Auto-check passed

Questions about Manual Test

What does Manual Test do?

Execute one of the model-runnable E2E test specs in testing/ (cli, datasets, serve, mcp, react) against a real ClickHouse instance. Manual Test is an agent skill from hypequery/hypequery. Execute one of the model-runnable E2E test specs in testing/ (cli, datasets, serve, mcp, react) against a real ClickHouse instance.

When should I use Manual Test?

Manual Test fits situations like: asked to manually test a package; run a testing spec; verify a package end-to-end against live data.

How do I install Manual Test in Claude Code?

Run `npx skills add hypequery/hypequery --skill manual-test -a claude-code`. Or copy the skill folder (.claude/skills/manual-test in hypequery/hypequery) into .claude/skills/manual-test in your project. Claude Code loads it when a task matches its description.

How do I install Manual Test in Codex?

Run `npx skills add hypequery/hypequery --skill manual-test -a codex`. Or copy the skill folder (.claude/skills/manual-test in hypequery/hypequery) into .agents/skills/manual-test in your project. Codex loads it when a task matches its description.

Can I use Manual Test 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 hypequery/hypequery --skill manual-test -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/manual-test, .gemini/skills/manual-test, .github/skills/manual-test and .opencode/skills/manual-test in your project.

What does Manual Test need to run?

Going by SKILL.md and its folder, Manual Test needs the command-line tools its instructions call (pnpm) and credentials named CLICKHOUSE_PASSWORD.

Does Manual Test 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 Manual Test 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 Manual Test use?

Manual Test has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Manual Test use?

About 618 tokens (SKILL.md is roughly 2.5k 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 Manual Test?

Skills that share tags, products or a category with Manual Test: Testing (ar-io/ar-io-node, 127 stars), Local Platform E2E (computesdk/benchmarks, 126 stars), ClickHouse RowBinary for Node.js (ClickHouse/agent-skills, 544 stars) and Clickhouse Best Practices (vemetric/vemetric, 395 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Manual Test?

hypequery (a GitHub organization) maintains it in hypequery/hypequery, which has 103 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 9, 2026.

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