skills.rest
otenycom
otenycomOFFICIAL
Explore all skills by this author →
WebsiteGitHub

helper-runner

Runs shipped helper scripts to count words or echo arguments via talent_run.

2|Updated Jun 26, 2026
Search Tags:#SQLite#demo#word count#sandboxed execution#helper scripts#talent_run#otenybot
One-click install
npx skills add https://github.com/otenycom/talents --skill helper-runner-otenycom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: helper-runner
Source: https://github.com/otenycom/talents/tree/main/skills/oteny-helper-runner-demo/helper-runner
Command: npx skills add https://github.com/otenycom/talents --skill helper-runner-otenycom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It demonstrates how a restricted Talent executes only the helper scripts it ships, giving bot builders a working reference for sandboxed script execution with auditable run logging. ## Core Features & Use Cases - Word Counting: Passes owner-supplied text as stdin to a word_count.py helper and returns the counts from its JSON stdout. - Argument Echoing: Sends words as argv to an echo_args.py helper and replies with the printed lines. - Run Ledger: Records every helper execution in a local sqlite database (runs.db, table helper_runs) created idempotently on first run. - Use Case: A Talent author copies this demo to learn how to expose exactly two whitelisted scripts through the talent_run tool, handle non-zero exit codes by quoting stderr, and refuse to run unlisted scripts. ## Quick Start Ask the bot to count the words in a sentence you send, and it will run the word count helper and reply with the counts.

Frequently Asked Questions about helper-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a helper script from an Oteny Talent?▼

Call the talent_run tool with the helper parameter set to the script path, such as oteny-helper-runner-demo/scripts/word_count.py. Pass text as stdin or words as argv, then read the result from stdout.

How to count words in text using a bot helper script?▼

Send the text as stdin to the word_count.py helper via talent_run. The helper prints JSON on stdout containing the counts, which the bot reads and replies with.

What happens if a helper script exits with a non-zero code?▼

The bot reports that the helper failed and quotes the stderr output. It does not invent or guess a result when exit_code is not 0.

Can the bot run scripts that are not shipped with the Talent?▼

No. The talent_run helper choices are limited to the scripts the Talent lists. If the owner names another script, the bot states it is not one of its helpers and does not try other tools.

Where are helper run records stored?▼

Every run lands in a local sqlite ledger at ~/.hermes/data/oteny-helper-runner-demo/runs.db in the helper_runs table. The schema is idempotent and applied on first run, and the ledger can be read with the sqlite3 command.

Related Skills

Explore More Software Engineering Skills→
jeff-hammjeff-hamm

ai-tools-sweep

Identify untracked artifacts in ~/.agents and migrate them into ai-tools.

Community
Intermediate
LGJ-JonathanLGJ-Jonathan

timeline-report

Generates a narrative report analyzing a project's full development history from claude-mem timeline data.

Official
Advanced
Rushtu99Rushtu99

openspec-new-change

Initialize an OpenSpec change workflow with schema selection and status checks.

Community
Intermediate
NightreaverNightreaver
6

ssh-exec-run

Execute whitelisted shell commands on remote hosts with audit logging.

Community
Advanced