Valve

Valve sizing and selection tool

Security Scan

The skill is internally consistent: it is a local CLI-like valve sizing/selection tool that reads/writes data under ~/.valve and does not request credentials or network access.

Purpose & Capability

Name/description match the implementation. The script provides add/list/search/remove/export/stats/config operations for valve entries and stores data under a configurable DATA_DIR (default ~/.valve). No unrelated capabilities (cloud access, system-wide changes, network calls) are present.

Instruction Scope

SKILL.md instructs running scripts/script.sh with specific commands; the script's runtime behavior matches those instructions. It only reads/writes files in the configured data directory, uses standard shell utilities (mkdir, cat, grep, sed, tail, wc, du, cp, date), and prints to stdout. It does not read other system files, environment variables beyond VALVE_DIR, or transmit data externally.

Install Mechanism

No install spec or external downloads. The skill is instruction-only with an included shell script; nothing is fetched from the network or written to arbitrary system locations as part of an installer.

Credentials

The skill requires no credentials and only optionally honors VALVE_DIR to change the storage path. This is proportionate to its function. Note: if a user sets VALVE_DIR to a sensitive or system path, the script will read/write there — that is expected behavior but is a user-supplied risk.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide agent settings. It only manages its own data and config within the chosen data directory.

Assessment

This skill appears to do what it says: a local CLI tool that stores JSONL entries under ~/.valve by default. Before installing/using: 1) review the included scripts/script.sh (already done) and ensure you trust it; 2) do not set VALVE_DIR to a system or sensitive path (e.g., /etc, /root, or any directory containing credentials), otherwise the tool may overwrite files there; 3) be aware it uses common utilities (grep/sed) and will modify files in the chosen data directory; and 4) if you need to run on macOS note sed -i semantics differ (script may need adjustment). Otherwise the footprint is local and coherent with its description.

Valve sizing and selection tool

Commands

status

scripts/script.sh status

Show current status

add

scripts/script.sh add

Add new entry

list

scripts/script.sh list

List all entries

search

scripts/script.sh search

Search entries

remove

scripts/script.sh remove

Remove entry by number

export

scripts/script.sh export

Export data to file

stats

scripts/script.sh stats

Show statistics

config

scripts/script.sh config

View or set config

help

scripts/script.sh help

version

scripts/script.sh version

Configuration

Use scripts/script.sh config <key> <value> to set preferences.

Variable	Required	Description
VALVE_DIR	No	Data directory (default: ~/.valve/)

Data Storage

All data stored in ~/.valve/ using JSONL format (one JSON object per line).

Output

Structured output to stdout. Exit code 0 on success, 1 on error.

---

Powered by BytesAgain | bytesagain.com | [e-mail]