Agent skill

Test Volo Flow

by VoloBuilds in VoloBuilds/create-volo-app

Tests the create-volo-app CLI end-to-end against a local volo-app template.

MITAuto-check passedTesting & QA

Install Test Volo Flow

skills CLI
$ npx skills add VoloBuilds/create-volo-app --skill test-volo-flow -a claude-code

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

GitHub CLI
$ gh skill install VoloBuilds/create-volo-app test-volo-flow --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/VoloBuilds/create-volo-app.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/test-volo-flow .claude/skills/test-volo-flow && 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-volo-flow
GitHub stars
135
Token cost
~1.1k tokens
SKILL.md length
434 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Tests the create-volo-app CLI end-to-end against a local volo-app template.

  • Works in 4 steps: Run scaffold + verification → Start dev server → Browser verification (AI) → …
  • Template changes
  • SKILL.md covers Shell commands, Fixed paths (nothing else is…, 1. Run scaffold + verification and 2. Start dev server, plus 4 more sections
  • Calls pnpm

What it does

Test Volo Flow is an agent skill from VoloBuilds/create-volo-app. Tests the create-volo-app CLI end-to-end against a local volo-app template. Use when validating CLI or template changes, running scaffold smoke tests, checking validateTemplate requirements, or verifying volo-config.json flows.

Its SKILL.md is about 1.1k 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 Testing & QA, covering QA and bug reports. The licence is MIT.

When your agent uses it

  • Template changes
  • Running scaffold smoke tests
  • Checking validateTemplate requirements
  • Verifying volo-config.json flows

Example prompts

  • “Use the test-volo-flow skill to test the create-volo-app CLI end-to-end against a local volo-app template”
  • “/test-volo-flow”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Run scaffold + verification
  2. Start dev server
  3. Browser verification (AI)
  4. Stop dev server and cleanup

What it can do on your machine

Read from SKILL.md and the folder at commit ce4ec34. 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 no API keys, tokens, secrets or passwords.

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

Context cost

Test Volo Flow loads about 1.1k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 434 words of instructions outside code blocks.

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

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 VoloBuilds/create-volo-app at commit ce4ec34, republished under its MIT licence (© VoloBuilds). 434 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/test-volo-flow/SKILL.md (or your agent's skills folder).
name
test-volo-flow
description
Tests the create-volo-app CLI end-to-end against a local volo-app template. Use when validating CLI or template changes, running scaffold smoke tests, checking validateTemplate requirements, or verifying volo-config.json flows.
disable-model-invocation
true

Test Volo Flow

End-to-end smoke test for create-volo-app using a local volo-app template.

Prerequisites: Open the create-volo-app repository as the workspace (or ensure the shell cwd is its root).

Use required_permissions: ["all"].

Shell commands

Run every command from the create-volo-app repository root. Do not prefix commands with cd … && — that triggers extra approval and is unnecessary. Set the shell tool's working_directory to the repo root instead.

Fixed paths (nothing else is touched)

PathPurpose
.tmp/volo-flow-testScaffolded test project
.tmp/volo-flow-test.state.jsonRun metadata (includes dev pid and frontend URL after dev)
.tmp/volo-flow-test.dev.logCaptured stdout/stderr from test:volo-flow:dev (for debugging API/service failures)

Template default: ../volo-app (override with VOLO_APP_TEMPLATE).

1. Run scaffold + verification

bash
pnpm test:volo-flow

Steps (each prints OK or FAILED):

  1. Check test dir (refuses to overwrite unless --force)
  2. Check pnpm
  3. Build CLI
  4. Scaffold test project
  5. Verify scaffold structure
  6. Verify builds

On failure: prints a summary, leaves .tmp/volo-flow-test in place for inspection.

Replace an existing test dir:

bash
pnpm test:volo-flow -- --force

2. Start dev server

bash
pnpm test:volo-flow:dev

Starts the scaffolded app in the background with VOLO_DEV_IGNORE_STDIN=1, waits for VOLO_DEV_FRONTEND_URL=… and VOLO_DEV_BACKEND_URL=… from scripts/run-dev.js, verifies backend GET / health, captures all service output to .tmp/volo-flow-test.dev.log, writes URLs and dev pid to state, then exits while services keep running.

On failure (timeout, process exit, or backend health check), prints a filtered excerpt from the dev log before exiting non-zero.

3. Browser verification (AI)

  1. Open the frontend URL from the dev command output or state file.
  2. Confirm Welcome to Your App!
  3. Optionally confirm the auth UI renders. Full sign-in is not required.
Show full SKILL.md (181 more words)Show less

4. Stop dev server and cleanup

bash
pnpm test:volo-flow:stop
pnpm test:volo-flow:cleanup

stop sends SIGINT to the pid recorded in state and waits for shutdown. cleanup stops the dev server if needed, then deletes only .tmp/volo-flow-test and .tmp/volo-flow-test.state.json.

validateTemplate() requirements

These files must exist in the template. Do not remove or rename them without updating src/utils/template.ts:

  • package.json (must include template.placeholders)
  • server/src/api.ts
  • server/src/trpc/router.ts
  • server/src/server.ts
  • server/src/lib/env.ts
  • server/.env.example
  • server/platforms/cloudflare/wrangler.toml.template
  • ui/platforms/cloudflare/wrangler.toml.template
  • ui/src/lib/firebase-config.template.json
  • scripts/post-setup.js
  • scripts/run-dev.js
  • scripts/deploy-guard.js
  • scripts/parse-wrangler-deploy-url.js
  • server/package.json (must include dev, deploy, deploy:cf scripts)

Local template copy excludes: node_modules/, .git/, dist/, .next/, data/.

Dev readiness log contract

pnpm test:volo-flow:dev parses stdout from the scaffolded app’s pnpm run dev → volo-app scripts/run-dev.js.

Required machine-readable lines (do not rename without updating scripts/test-volo-flow.mjs):

text
VOLO_DEV_FRONTEND_URL=http://localhost:5501
VOLO_DEV_BACKEND_URL=http://localhost:5500

After both URLs appear, the runner polls GET {backendUrl}/ until { "status": "ok" } or times out (30s).

All dev stdout/stderr during startup is appended to .tmp/volo-flow-test.dev.log. On startup/health failure, the runner prints a filtered excerpt (lines tagged [server], [database], errors, etc.) plus the full log path. After dev-ready, the runner exits (dev server keeps running in the background); the log file retains startup output only.

Legacy fallbacks: human Frontend: / Backend: lines for older templates.

© VoloBuilds, 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 .cursor/skills/test-volo-flow of VoloBuilds/create-volo-app.

Open the folder on GitHubat commit ce4ec34

Compare with similar skills

Test Volo Flow 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 Volo Flow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Volo Flow this skillVoloBuilds/create-volo-app135—~1.1kAutomated safety check: PassMIT
Reproduce Chat Statesdifferent-ai/openwork24k—~673Automated safety check: PassCustom licence
Dynamo Jira TicketDynamoDS/Dynamo2k—~1.1kAutomated safety check: PassApache-2.0
Moav E2EMotherofallVPNs/MoaV448—~1.9kAutomated safety check: NotesMIT
Creating A Coral TaskHuman-Agent-Society/CORAL1.1k—~2.2kAutomated safety check: PassApache-2.0
Launch Rlmarin-community/marin3.9k—~894Automated safety check: PassApache-2.0

Similar skills

  • Reproduce Chat States

    different-ai/openwork

    Fires known chat states in the running OpenWork desktop app, such as provider errors, retries and tool steps, so you can check how each renders.

    24k GitHub stars~673 tokensUpdated today
    Testing & QAAuto-check passed
  • Dynamo Jira Ticket

    DynamoDS/Dynamo

    Create structured Jira tickets for Dynamo from bug reports, failing tests, or feature requests.

    2k GitHub stars~1.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Moav E2E

    MotherofallVPNs/MoaV

    Run and debug MoaV's end-to-end tests — real protocol connectivity (client-test.sh) and the moav CLI smoke test — against a LIVE server, via the self-hosted e2e workflow or a local test VPS.

    448 GitHub stars~1.9k tokensUpdated yesterday
    Testing & QAAuto-check: notes
  • Creating A Coral Task

    Human-Agent-Society/CORAL

    Author a new CORAL task — the three pieces that must line up (task.yaml, seed/, a packaged grader/), the coral init → coral validate → smoke-test loop, and how to pick a grader pattern (stdout…

    1.1k GitHub stars~2.2k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Launch Rl

    marin-community/marin

    Define, validate, submit, or restart a Marin SkyRL experiment through its artifact main.

    3.9k GitHub stars~894 tokensUpdated today
    Testing & QAAuto-check passed
  • Actionbook Web Test

    actionbook/actionbook

    Run browser-based web tests against websites using Actionbook CLI.

    1.6k GitHub stars~9.7k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed

Categories

Questions about Test Volo Flow

What does Test Volo Flow do?

Tests the create-volo-app CLI end-to-end against a local volo-app template. Test Volo Flow is an agent skill from VoloBuilds/create-volo-app. Tests the create-volo-app CLI end-to-end against a local volo-app template.

When should I use Test Volo Flow?

Test Volo Flow fits situations like: template changes; running scaffold smoke tests; checking validateTemplate requirements; verifying volo-config.json flows.

How do I install Test Volo Flow in Claude Code?

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

How do I install Test Volo Flow in Codex?

Run `npx skills add VoloBuilds/create-volo-app --skill test-volo-flow -a codex`. Or copy the skill folder (.cursor/skills/test-volo-flow in VoloBuilds/create-volo-app) into .agents/skills/test-volo-flow in your project. Codex loads it when a task matches its description.

Can I use Test Volo Flow 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 VoloBuilds/create-volo-app --skill test-volo-flow -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-volo-flow, .gemini/skills/test-volo-flow, .github/skills/test-volo-flow and .opencode/skills/test-volo-flow in your project.

What does Test Volo Flow need to run?

Going by SKILL.md and its folder, Test Volo Flow needs the command-line tools its instructions call (pnpm).

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

Test Volo Flow 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 Volo Flow use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Volo Flow?

Skills that share tags, products or a category with Test Volo Flow: Reproduce Chat States (different-ai/openwork, 24k stars), Dynamo Jira Ticket (DynamoDS/Dynamo, 2k stars), Moav E2E (MotherofallVPNs/MoaV, 448 stars) and Creating A Coral Task (Human-Agent-Society/CORAL, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Volo Flow?

VoloBuilds (a GitHub user) maintains it in VoloBuilds/create-volo-app, which has 135 GitHub stars. The repository was last updated on June 17, 2026.

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