Agent skill

NodeBridge Handler Tester

by neovateai in neovateai/neovate-code

Runs Neovate Code's NodeBridge message handlers from the command line with bun scripts/test-nodebridge.ts, listing handlers and passing parameters.

MITAuto-check passedDevelopment

Install NodeBridge Handler Tester

skills CLI
$ npx skills add neovateai/neovate-code --skill test-nodebridge-handler -a claude-code

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

GitHub CLI
$ gh skill install neovateai/neovate-code test-nodebridge-handler --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/neovateai/neovate-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/test-nodebridge-handler .claude/skills/test-nodebridge-handler && 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-nodebridge-handler
GitHub stars
1.6k
Token cost
~711 tokens
SKILL.md length
172 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Runs Neovate Code's NodeBridge message handlers from the command line with bun scripts/test-nodebridge.ts, listing handlers and passing parameters.

  • Works in 2 steps: Request - JSON of the data sent to the… → Response - JSON of the handler's return…
  • Testing a NodeBridge handler without launching the full app
  • SKILL.md covers Overview, Usage, Parameter Passing and Available Handler Categories, plus 3 more sections
  • Calls bun

What it does

The skill documents one script, scripts/test-nodebridge.ts, run with bun. A list flag prints every available handler, and naming a handler runs it with options passed either as key-value flags, where true, false and numbers are converted automatically and a bare flag becomes true, or as a JSON string through a data option that takes priority.

A table groups handlers by category: models, config, providers, mcp, output styles, project, projects, sessions, skills, slash commands, git and utils. Examples show testing a model with a prompt and timeout, listing projects with session details, reading skill details and checking git status in a given directory. The script prints the request JSON, then the response JSON with timing, shaped as a success with data or as an error.

When your agent uses it

  • Testing a NodeBridge handler without launching the full app
  • Listing which NodeBridge handlers are available
  • Passing nested JSON parameters to a handler under test

Example prompts

  • “List all NodeBridge handlers, then run models.list.”
  • “Test the skills.get handler for the skill named my-skill and show the response timing.”
  • “Call git.status through the test script for the repo at ../api.”

Requirements

  • Bun
  • The neovate-code repository with scripts/test-nodebridge.ts

Workflow steps

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

  1. Request - JSON of the data sent to the handler
  2. Response - JSON of the handler's return value with timing

What it can do on your machine

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

    • bun

    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

NodeBridge Handler Tester loads about 711 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 172 words of instructions outside code blocks.

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

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 neovateai/neovate-code at commit 0a24b36, republished under its MIT licence (© neovateai). 172 words, ~711 tokens.

Download SKILL.mdSave it as .claude/skills/test-nodebridge-handler/SKILL.md (or your agent's skills folder).
name
test-nodebridge-handler
description
Use this skill when testing NodeBridge handlers using `bun scripts/test-nodebridge.ts`, including listing available handlers and passing parameters

Test NodeBridge Handler

Overview

This skill guides the process of testing NodeBridge message handlers using the test script.

Usage

List All Available Handlers
bash
bun scripts/test-nodebridge.ts --list
Test a Specific Handler
bash
bun scripts/test-nodebridge.ts <handler> [options]

Parameter Passing

Key-Value Format
bash
bun scripts/test-nodebridge.ts handler.name --key=value --flag=true --count=42
  • Values are auto-converted: true/false → Boolean, numbers → Number
  • Boolean flags without value: --verbose becomes { verbose: true }
JSON Data Format

For complex data, use --data with JSON (takes priority over --key=value):

bash
bun scripts/test-nodebridge.ts handler.name --data='{"key":"value","nested":{"foo":"bar"}}'

Available Handler Categories

CategoryExample Handlers
modelsmodels.list, models.test
configconfig.list
providersproviders.list
mcpmcp.list, mcp.getStatus
outputStylesoutputStyles.list
projectproject.getRepoInfo, project.workspaces.list
projectsprojects.list
sessionssessions.list
skillsskills.list, skills.get, skills.add, skills.remove, skills.preview, skills.install
slashCommandslashCommand.list
gitgit.status, git.detectGitHub
utilsutils.getPaths, utils.detectApps, utils.playSound

Examples

Test Model
bash
bun scripts/test-nodebridge.ts models.test --model=anthropic/claude-sonnet-4-20250514
bun scripts/test-nodebridge.ts models.test --model=openai/gpt-4o --prompt="Say hello" --timeout=5000
List Models
bash
bun scripts/test-nodebridge.ts models.list
Get File Paths
bash
bun scripts/test-nodebridge.ts utils.getPaths --cwd=/path/to/dir --maxFiles=100
List Projects
bash
bun scripts/test-nodebridge.ts projects.list --includeSessionDetails=true
Get Skill Details
bash
bun scripts/test-nodebridge.ts skills.get --name=my-skill
Git Status
bash
bun scripts/test-nodebridge.ts git.status --cwd=/path/to/repo

Output Format

The script outputs:

  1. Request - JSON of the data sent to the handler
  2. Response - JSON of the handler's return value with timing

Success response structure:

json
{
  "success": true,
  "data": { ... }
}

Error response structure:

json
{
  "success": false,
  "error": "Error message"
}

Notes

  • The script has a 30-second timeout for all requests
  • Exit code 0 on success, 1 on error
  • Use -h or --help for help message

© neovateai, 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-nodebridge-handler of neovateai/neovate-code.

Open the folder on GitHubat commit 0a24b36

Compare with similar skills

NodeBridge Handler Tester 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.

NodeBridge Handler Tester compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
NodeBridge Handler Tester this skillneovateai/neovate-code1.6k—~711Automated safety check: PassMIT
Template Instantiationdotnet/skills5.6k1 repos~2.8kAutomated safety check: PassMIT
Reviewtrailofbits/coop762—~3.1kAutomated safety check: PassApache-2.0
Diff-Driven QASkyvern-AI/skyvern23k—~4.7kAutomated safety check: WarnAGPL-3.0
Swing Flatlaf Miglayout Principleslakernote/easy-postman721—~3.7kAutomated safety check: PassApache-2.0
QA Test and Fixgarrytan/gstack136k—~13kAutomated safety check: NotesMIT

Similar skills

  • Official

    Creates .NET projects from templates with validated parameters, smart defaults, Central Package Management adaptation, and latest NuGet version resolution.

    5.6k GitHub starsUsed in 1 repo~2.8k tokens
    DevelopmentAuto-check passed
  • Review

    trailofbits/coop

    Official

    Review a coop pull request or local diff with independent, self-validated correctness, design, convention, security, API, test, documentation, and comment lenses.

    762 GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Diff-Driven QA

    Skyvern-AI/skyvern

    Reads your git diff, decides whether the change needs browser QA, API checks or repo tests, runs that validation and reports pass or fail with evidence.

    23k GitHub stars~4.7k tokensUpdated today
    Testing & QAAuto-check: warnings
  • A skill your agent uses when modifying EasyPostman Swing forms, tool-window panels, localized English/Chinese text layouts, or FlatLaf/MigLayout layouts, especially when refactors introduce clipped…

    721 GitHub stars~3.7k tokensUpdated today
    Testing & QAAuto-check passed
  • QA Test and Fix

    garrytan/gstack

    Tests a site or service for bugs, fixes what it finds with one atomic commit per fix, and reports fix evidence and a ship-readiness summary at one of three depths.

    136k GitHub stars~13k tokensUpdated today
    Testing & QAAuto-check: notes
  • Type Safety

    idavidov13/agentic-playwright

    TypeScript type safety conventions for the Playwright scaffold — the "no any" rule, Zod 4 schema patterns (z.strictObject, top-level validators like z.uuid / z.email / z.url / z.int / z.enum)…

    223 GitHub stars~3.5k tokensUpdated 6 days ago
    Testing & QAAuto-check passed

More from neovateai/neovate-code

  • Add NodeBridge Handler

    neovateai/neovate-code

    Walks through adding a message handler to NodeBridge in Neovate Code, from the implementation and its types to an optional test entry and a run with Bun.

    1.6k GitHub stars~1k tokensUpdated 6 mo ago
    Auto-check passed

Questions about NodeBridge Handler Tester

What does NodeBridge Handler Tester do?

Runs Neovate Code's NodeBridge message handlers from the command line with bun scripts/test-nodebridge.ts, listing handlers and passing parameters. ts, run with bun. A list flag prints every available handler, and naming a handler runs it with options passed either as key-value flags, where true, false and numbers are converted automatically and a bare flag becomes true, or as a JSON string through a data option that takes priority.

When should I use NodeBridge Handler Tester?

NodeBridge Handler Tester fits situations like: testing a NodeBridge handler without launching the full app; listing which NodeBridge handlers are available; passing nested JSON parameters to a handler under test.

How do I install NodeBridge Handler Tester in Claude Code?

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

How do I install NodeBridge Handler Tester in Codex?

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

Can I use NodeBridge Handler Tester 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 neovateai/neovate-code --skill test-nodebridge-handler -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-nodebridge-handler, .gemini/skills/test-nodebridge-handler, .github/skills/test-nodebridge-handler and .opencode/skills/test-nodebridge-handler in your project.

What does NodeBridge Handler Tester need to run?

Going by SKILL.md and its folder, NodeBridge Handler Tester needs the command-line tools its instructions call (bun). Our summary lists: Bun; The neovate-code repository with scripts/test-nodebridge.ts.

Does NodeBridge Handler Tester 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 NodeBridge Handler Tester 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 NodeBridge Handler Tester use?

NodeBridge Handler Tester 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 NodeBridge Handler Tester use?

About 711 tokens (SKILL.md is roughly 2.8k 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 NodeBridge Handler Tester?

Skills that share tags, products or a category with NodeBridge Handler Tester: Template Instantiation (dotnet/skills, 5.6k stars), Review (trailofbits/coop, 762 stars), Diff-Driven QA (Skyvern-AI/skyvern, 23k stars) and Swing Flatlaf Miglayout Principles (lakernote/easy-postman, 721 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains NodeBridge Handler Tester?

neovateai (a GitHub organization) maintains it in neovateai/neovate-code, which has 1,558 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on March 24, 2026.

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