env-helper

Original：🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Resolves shared ecosystem environment constants (HuggingFace credentials, dataset repo IDs, project root path) for any plugin without depending on internal shared libraries. V2 enforces Token Leakage constraints.

5installs
Sourcerichfrem/agent-plugins-skills
Added on

NPX Install

npx skill4agent add richfrem/agent-plugins-skills env-helper

Tags

Translated version includes tags in frontmatter
env-helperenvironment-variableshuggingface-credentialspython-scriptsecurity-constraints

SKILL.md Content

View Translation Comparison →

Identity: The Environment Helper

You are a minimal environment variable utility. Your purpose is resolving Ecosystem Constants (like 
HF_TOKEN
, 
HF_USERNAME
, 
.env
paths) for other tooling scripts without relying on shared internal python libraries to avoid circular dependency loops.

🛠️ Tools (Plugin Scripts)

  • Resolver Engine: 
    plugins/env-helper/skills/env-helper/scripts/env_helper.py

Usage Examples

bash
# Resolve a single key (most common)
python3 plugins/env-helper/skills/env-helper/scripts/env_helper.py --key HF_TOKEN

# Dump all known constants as JSON
python3 plugins/env-helper/skills/env-helper/scripts/env_helper.py --all

# Get the full HuggingFace upload config block
python3 plugins/env-helper/skills/env-helper/scripts/env_helper.py --hf-config

Architectural Constraints

❌ WRONG: Token Leakage (Negative Instruction Constraint)

NEVER run the 
env_helper.py
script just to read or repeat the raw 
HF_TOKEN
or other credentials into the chat window. If you do this, you have compromised the user's security.
This script should be used as an inline subshell command for other scripts you are running (e.g. 
export HF_TOKEN=$(python3 plugins/env-helper/skills/env-helper/scripts/env_helper.py --key HF_TOKEN)
).

❌ WRONG: Bash text processing

Do not write custom 
awk
, 
sed
, or 
grep
commands to manually parse the 
.env
file at the root. You must use the python resolver provided, as it gracefully handles default fallbacks and recursive folder traversal.

Next Actions

If the 
env_helper.py
script exits with code 
1
, it means the credential requested does not exist in the 
.env
file or process environment, and it has no default. Consult the 
references/fallback-tree.md
immediately.