agentsclimarketplace

Readonly diagnostics runner

Skill iiwish/skillrun/examples/readonly_diagnostics_runner

Local-first Agent Skill Runtime for packaging SOPs, schemas, preflight checks, run records, and MCP tools as executable skill capsules.

Install
npx -y skills add iiwish/skillrun --skill readonly_diagnostics_runner

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.1 KB, 243 tokens by cl100k_base, as published. Nobody here has run it

Read-only Diagnostics Runner

Purpose

This SkillRun capsule runs a small allowlist of read-only diagnostic commands. It demonstrates how a high-risk terminal-shaped action can be narrowed into a typed skill contract.

SOP

  1. Accept only named diagnostics from the schema. Do not accept arbitrary shell strings.
  2. Run commands without shell=True.
  3. Do not support redirection, pipes, command chaining, mutation commands, package installs or process killing.
  4. Capture stdout, stderr, exit code and timeout status.
  5. Truncate oversized output so the Agent can recover without flooding context.

Allowed Diagnostics

  • pwd: print the capsule working directory.
  • list: list files in the capsule working directory.
  • git_status: run git status --short when the current directory is inside a Git repository.

Recovery Guidance

If a diagnostic fails, inspect the structured exit_code, stdout and stderr. Do not retry with a broader shell command.

Prohibited Behavior

  • Do not pass arbitrary command strings.
  • Do not run destructive commands.
  • Do not treat this capsule as a general-purpose shell or an OS sandbox.

What ships with it: 4 files

3.3 KB alongside SKILL.md, 1 of them executable

examples/

Keep looking

Skills are one crate of 327,167. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.