← Back to Skills Marketplace
Tinyfish Agent Run
by
Val Alexander
· GitHub ↗
· v1.0.0
· MIT-0
121
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tinyfish-agent-run
Description
Run a TinyFish automation agent against a URL and stream live progress events (STARTED / PROGRESS / COMPLETE) as one-line JSON events. Use when you want to e...
Usage Guidance
This skill appears to do what it says: it streams TinyFish agent SSE events to stdout and requires only TINYFISH_API_KEY. Before installing, ensure: (1) you trust the TinyFish service and the API key you will supply (keys can trigger runs and possibly incur charges); (2) run-time dependencies curl and python3 are present on your system (the metadata does not declare them); (3) do not provide broader credentials—only the TinyFish API key is needed; (4) if you plan to send sensitive URLs or credentials in the 'goal' or page content, remember this content is transmitted to the TinyFish API for processing; and (5) consider running it in a confined environment or review TinyFish's privacy/docs if you need to limit data exposure.
Capability Analysis
Type: OpenClaw Skill
Name: tinyfish-agent-run
Version: 1.0.0
The skill is a straightforward integration for the TinyFish AI automation service. It uses a shell script (scripts/agent-run.sh) to send a user-provided URL and goal to the official API endpoint (https://agent.tinyfish.ai) and streams progress events. The implementation follows security best practices by using Python for safe JSON encoding of shell arguments and contains no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, and script all consistently implement an SSE streamer that POSTs to https://agent.tinyfish.ai/v1/automation/run-sse using X-API-Key: $TINYFISH_API_KEY. The only mismatch is that the script invokes curl and python3 but the skill metadata did not declare any required binaries; these runtime dependencies should be declared so callers know they'll be needed.
Instruction Scope
Runtime instructions and the script only (a) check for TINYFISH_API_KEY, (b) POST a JSON body containing the provided URL and goal to the TinyFish API, and (c) re-emit SSE 'data:' frames as one-line JSON on stdout. The instructions do not read local files, other env vars, or send data to any endpoint other than the documented TinyFish API.
Install Mechanism
There is no install spec (instruction-only skill) and the included script is small and clear. No remote downloads or archive extraction occur. Note: because no install step exists, the script will run directly and thus requires runtime binaries (curl, python3) to be present.
Credentials
Only TINYFISH_API_KEY is required and is appropriate for interacting with the TinyFish API. Users should be aware that this key authorizes runs against the remote TinyFish service and may incur actions/costs; the key should follow least-privilege practices.
Persistence & Privilege
The skill does not request persistent/always-on presence (always:false), does not modify other skill configurations, and does not access system config paths. Agent autonomous invocation remains possible (platform default) but is not combined with additional privileges by this skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tinyfish-agent-run - After installation, invoke the skill by name or use
/tinyfish-agent-run - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of tinyfish-agent-run.
- Run a TinyFish automation agent on any URL with a defined goal.
- Streams live, one-line JSON progress events (STARTED, PROGRESS, COMPLETE) for easy real-time tracking.
- Requires TINYFISH_API_KEY environment variable for authentication.
- Simple stdout integration allows direct use in subagents, TUIs, or pipelines.
- Detailed output format and usage examples included in documentation.
Metadata
Frequently Asked Questions
What is Tinyfish Agent Run?
Run a TinyFish automation agent against a URL and stream live progress events (STARTED / PROGRESS / COMPLETE) as one-line JSON events. Use when you want to e... It is an AI Agent Skill for Claude Code / OpenClaw, with 121 downloads so far.
How do I install Tinyfish Agent Run?
Run "/install tinyfish-agent-run" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tinyfish Agent Run free?
Yes, Tinyfish Agent Run is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tinyfish Agent Run support?
Tinyfish Agent Run is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tinyfish Agent Run?
It is built and maintained by Val Alexander (@bunsdev); the current version is v1.0.0.
More Skills