Agent skill

Viewer Smoke

by iopsystems in iopsystems/rezolus

Run the end-to-end viewer smoke test (tests/viewersmoke.sh).

Custom licenceAuto-check passedTesting & QA

Install Viewer Smoke

skills CLI
$ npx skills add iopsystems/rezolus --skill viewer-smoke -a claude-code

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

GitHub CLI
$ gh skill install iopsystems/rezolus viewer-smoke --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/iopsystems/rezolus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/viewer-smoke .claude/skills/viewer-smoke && 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
viewer-smoke
GitHub stars
275
Token cost
~849 tokens
SKILL.md length
395 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

Run the end-to-end viewer smoke test (tests/viewersmoke.sh).

  • Works in 3 steps: Run the script → Interpret the result → If the script fails, do not paper over…
  • Tasks that involve QA and bug reports
  • SKILL.md covers Steps, What it covers, What it does not cover and Requirements, plus 1 more section
  • Calls bash and cargo

What it does

Viewer Smoke is an agent skill from iopsystems/rezolus. Run the end-to-end viewer smoke test (tests/viewersmoke.sh). Spawns rezolus view in upload-only, file, A/B, and proxy modes, exercises the API endpoints, and verifies experiment attach/detach. Use after any change touching src/viewer/ or before opening a viewer-related PR.

Its SKILL.md is about 850 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 and REST APIs. The repository describes itself as: High-resolution, low-overhead systems and service telemetry.

When your agent uses it

  • Tasks that involve QA and bug reports
  • Tasks that involve REST APIs

Example prompts

  • “/viewer-smoke”

Workflow steps

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

  1. Run the script
  2. Interpret the result
  3. If the script fails, do not paper over by editing the assertions.

What it can do on your machine

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

    • bash
    • cargo

    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

Viewer Smoke loads about 849 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 395 words of instructions outside code blocks.

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

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 395 words (~849 tokens).

“Runs the viewer in four configurations against checked-in demo parquets and asserts the public API endpoints behave correctly. Designed to be invoked from a PR/commit hook so behavior regressions in src/viewer/ show up before review.”

— opening of SKILL.md by iopsystems, Custom licence
name
viewer-smoke

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/viewer-smoke of iopsystems/rezolus.

Open the folder on GitHubat commit 4b6863a

Compare with similar skills

Viewer Smoke 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.

Viewer Smoke compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Viewer Smoke this skilliopsystems/rezolus275—~849Automated safety check: PassCustom licence
Test Via APILunCoSim/lunco-sim107—~7.8kAutomated safety check: PassApache-2.0
Fleet SupervisorApra-Labs/apra-fleet101—~3.6kAutomated safety check: PassCustom licence
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Testing Mwaa Workflowaws/agent-toolkit-for-aws2.8k—~3.8kAutomated safety check: PassApache-2.0
Reproduce Chat Statesdifferent-ai/openwork24k—~673Automated safety check: PassCustom licence

Similar skills

  • Test Via API

    LunCoSim/lunco-sim

    How to verify luncosim changes end-to-end without asking the user to click.

    107 GitHub stars~7.8k tokensUpdated today
    Testing & QAAuto-check passed
  • Fleet Supervisor

    Apra-Labs/apra-fleet

    How to start/smoke-test the supervisor process itself, and start, check, and kill fleet-sprints via its HTTP API only (POST /api/sprints on localhost:8787).

    101 GitHub stars~3.6k tokensUpdated today
    Testing & QAAuto-check passed
  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Testing Mwaa Workflow

    aws/agent-toolkit-for-aws

    Official

    Tests Amazon MWAA workflow execution end-to-end: trigger a run and monitor it to completion for Provisioned (Python DAG, via Airflow REST API) and Serverless (YAML workflow, via StartWorkflowRun).

    2.8k GitHub stars~3.8k tokensUpdated today
    Backend & APIsAuto-check passed
  • 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

More from iopsystems/rezolus

All 11 skills in this repo
  • Document Feature

    iopsystems/rezolus

    Write or update the CLI --help text and README section for a new or changed rezolus feature (a subcommand, flag, mode, or behavior change), then prove the help is usable by dispatching a fresh…

    275 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Reviewing Samplers

    iopsystems/rezolus

    A skill your agent uses when reviewing a Rezolus sampler change before merge — a new sampler, a change to an existing sampler's probes/refresh/metrics, or core changes that affect samplers; or…

    275 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Viewer Render

    iopsystems/rezolus

    Render the running viewer in a real headless browser and assert on what it drew — element geometry, computed colours, wrap points, truncated labels, console errors.

    275 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Prerelease

    iopsystems/rezolus

    Tag and push a prerelease from the current Cargo.toml version.

    275 GitHub stars~514 tokensUpdated yesterday
    Auto-check: notes
  • Engineering Journal

    iopsystems/rezolus

    A skill your agent uses when starting or picking up a non-trivial effort (feature, investigation, perf probe, refactor, migration) in a shared repo where teammates or future agents must coordinate…

    275 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • PR

    iopsystems/rezolus

    Create a feature branch, commit changes, push, and open a PR against iopsystems/rezolus

    275 GitHub stars~906 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Viewer Smoke

What does Viewer Smoke do?

Run the end-to-end viewer smoke test (tests/viewersmoke.sh). Viewer Smoke is an agent skill from iopsystems/rezolus.sh).

When should I use Viewer Smoke?

Viewer Smoke fits situations like: tasks that involve QA and bug reports; tasks that involve REST APIs.

How do I install Viewer Smoke in Claude Code?

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

How do I install Viewer Smoke in Codex?

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

Can I use Viewer Smoke 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 iopsystems/rezolus --skill viewer-smoke -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/viewer-smoke, .gemini/skills/viewer-smoke, .github/skills/viewer-smoke and .opencode/skills/viewer-smoke in your project.

What does Viewer Smoke need to run?

Going by SKILL.md and its folder, Viewer Smoke needs the command-line tools its instructions call (bash and cargo).

Does Viewer Smoke 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 Viewer Smoke 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 Viewer Smoke use?

Viewer Smoke 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 Viewer Smoke use?

About 849 tokens (SKILL.md is roughly 3.4k 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 Viewer Smoke?

Skills that share tags, products or a category with Viewer Smoke: Test Via API (LunCoSim/lunco-sim, 107 stars), Fleet Supervisor (Apra-Labs/apra-fleet, 101 stars), Use Yaak (mountain-loop/yaak, 19k stars) and Testing Mwaa Workflow (aws/agent-toolkit-for-aws, 2.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Viewer Smoke?

iopsystems (a GitHub organization) maintains it in iopsystems/rezolus, which has 275 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

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