Agent skill

Test Local

by searlsco in searlsco/prove_it

Test proveit from source against an example project or temp directory.

MITAuto-check passed

Install Test Local

skills CLI
$ npx skills add searlsco/prove_it --skill test-local -a claude-code

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

GitHub CLI
$ gh skill install searlsco/prove_it test-local --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/searlsco/prove_it.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/test-local .claude/skills/test-local && 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
test-local
GitHub stars
198
Token cost
~518 tokens
SKILL.md length
119 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Test proveit from source against an example project or temp directory.

  • Works in 4 steps: Identify the test target. If the user… → Set up the PATH shim so prove_it… → Run the requested test. Common scenarios → …
  • You want to verify hook behavior end-to-end without a Homebrew release
  • SKILL.md covers Steps and Notes
  • Calls git and node

What it does

Test Local is an agent skill from searlsco/prove_it. Test proveit from source against an example project or temp directory. Use when you want to verify hook behavior end-to-end without a Homebrew release.

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

It works with Homebrew. The repository describes itself as: The verification harness that Claude Code should have shipped with. The licence is MIT.

When your agent uses it

  • You want to verify hook behavior end-to-end without a Homebrew release

Example prompts

  • “/test-local”

Workflow steps

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

  1. Identify the test target. If the user didn't specify, use example/basic/.
  2. Set up the PATH shim so prove_it resolves to the repo's cli.js
  3. Run the requested test. Common scenarios
  4. Report the output and whether the behavior matches expectations.

What it can do on your machine

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

    • git
    • node

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

  • Network

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

Test Local loads about 518 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 119 words of instructions outside code blocks.

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

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 searlsco/prove_it at commit eedd8da, republished under its MIT licence (© searlsco). 119 words, ~518 tokens.

Download SKILL.mdSave it as .claude/skills/test-local/SKILL.md (or your agent's skills folder).
name
test-local
description
Test prove_it from source against an example project or temp directory. Use when you want to verify hook behavior end-to-end without a Homebrew release.

Test prove_it locally

Run prove_it from the repo source (not the Homebrew install) to test hook behavior.

Steps

  1. Identify the test target. If the user didn't specify, use example/basic/.

  2. Set up the PATH shim so prove_it resolves to the repo's cli.js:

    bash
    export PATH="$(git rev-parse --show-toplevel)/test/bin:$PATH"
    which prove_it   # should show test/bin/prove_it
  3. Run the requested test. Common scenarios:

    Test a specific hook event:

    bash
    cd example/basic
    echo '{"hook_event_name":"Stop","session_id":"test","cwd":"."}' | prove_it hook claude:Stop

    Test SessionStart:

    bash
    echo '{"hook_event_name":"SessionStart","source":"startup","session_id":"test","cwd":"."}' | prove_it hook claude:SessionStart

    Test PreToolUse (edit protection):

    bash
    echo '{"hook_event_name":"PreToolUse","tool_name":"Edit","tool_input":{"file_path":"src/greet.js"},"session_id":"test","cwd":"."}' | prove_it hook claude:PreToolUse

    Test PreToolUse (commit gate):

    bash
    echo '{"hook_event_name":"PreToolUse","tool_name":"Bash","tool_input":{"command":"git commit -m test"},"session_id":"test","cwd":"."}' | prove_it hook claude:PreToolUse

    Test init in a temp directory:

    bash
    tmpdir=$(mktemp -d)
    cd "$tmpdir" && git init
    prove_it init --no-default-checks
    cat .claude/prove_it/config.json
    prove_it deinit
    rm -rf "$tmpdir"

    Test doctor:

    bash
    cd example/basic
    prove_it doctor
  4. Report the output and whether the behavior matches expectations.

Notes

  • The shim at test/bin/prove_it just does exec node ../../cli.js "$@"
  • All $(prove_it prefix)/libexec/* commands in configs will also resolve through the shim
  • This tracks with the current git ref—check out any commit to test that version

© searlsco, MIT. 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 .claude/skills/test-local of searlsco/prove_it.

Open the folder on GitHubat commit eedd8da

Compare with similar skills

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

Test Local compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Local this skillsearlsco/prove_it198—~518Automated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.6kAutomated safety check: PassGPL-3.0
Release Asc CLIrorkai/App-Store-Connect-CLI7.7k—~2.4kAutomated safety check: PassMIT
CodexBar Usage Readersteipete/CodexBar22k—~320Automated safety check: PassMIT
Youtube Clipperop7418/Youtube-clipper-skill2.2k—~1.6kAutomated safety check: NotesMIT
Reproduce macOS Python FlavorsNuitka/Nuitka15k—~1.7kAutomated safety check: PassAGPL-3.0

Similar skills

  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Release Asc CLI

    rorkai/App-Store-Connect-CLI

    Publish and verify a new release of the App-Store-Connect-CLI repository.

    7.7k GitHub stars~2.4k tokensUpdated yesterday
    MobileAuto-check passed
  • CodexBar Usage Reader

    steipete/CodexBar

    CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.

    22k GitHub stars~320 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Youtube Clipper

    op7418/Youtube-clipper-skill

    YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。

    2.2k GitHub stars~1.6k tokensUpdated 8 mo ago
    Media & CreativeAuto-check: notes
  • Reproduce macOS Nuitka issues across Python distributions and GitHub Actions Python packaging.

    15k GitHub stars~1.7k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • CodexBar macOS Release

    steipete/CodexBar

    Releases a signed, notarized CodexBar build: confirms the changelog, resolves signing credentials from 1Password, runs the release script in tmux, and updates the Sparkle appcast and Homebrew tap.

    22k GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed

More from searlsco/prove_it

  • Session Log

    searlsco/prove_it

    Inspect proveit session logs—review history, reviewer verdicts, and session state.

    198 GitHub stars~486 tokensUpdated 17 days ago
    Auto-check passed
  • Prove Feature

    searlsco/prove_it

    Create a temporary real project and prove a proveit feature works (or doesn't) end-to-end.

    198 GitHub stars~5.7k tokensUpdated 17 days ago
    Auto-check passed

Works with

Questions about Test Local

What does Test Local do?

Test proveit from source against an example project or temp directory. Test Local is an agent skill from searlsco/prove_it. Test proveit from source against an example project or temp directory.

When should I use Test Local?

Test Local fits situations like: you want to verify hook behavior end-to-end without a Homebrew release.

How do I install Test Local in Claude Code?

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

How do I install Test Local in Codex?

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

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

What does Test Local need to run?

Going by SKILL.md and its folder, Test Local needs the command-line tools its instructions call (git and node).

Does Test Local access the network?

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

Is Test Local 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 Test Local use?

Test Local is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Test Local use?

About 518 tokens (SKILL.md is roughly 2.1k 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 Test Local?

Skills that share tags, products or a category with Test Local: Mole CLI Release Flow (tw93/Mole, 70k stars), Release Asc CLI (rorkai/App-Store-Connect-CLI, 7.7k stars), CodexBar Usage Reader (steipete/CodexBar, 22k stars) and Youtube Clipper (op7418/Youtube-clipper-skill, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Local?

searlsco (a GitHub organization) maintains it in searlsco/prove_it, which has 198 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 22, 2026.

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