richfrem/agent-plugins-skills / plugins/dev-utils/.apm/skills/managing-huggingface-assets
managing-huggingface-assets
VerifiedSets up, downloads from and uploads to HuggingFace repositories with credential hygiene and exponential backoff. Use to validate HuggingFace credentials and dataset structure, download files, snapshots or model weights, or upload files, folders, learning snapshots and JSONL traces. Not for searching the Hub or other storage providers.
Managing HuggingFace Assets (managing-huggingface-assets)
Three modes share one credential library (scripts/hf_config.py).
Contents
- Constraints • Quick Start • Modes • Workflow • Verification • References
Constraints
- Secret hygiene:
HUGGING_FACE_TOKENcomes only from the shell environment; never write it to.env, Git, arguments or logs. - Backoff: retry HTTP 429/503 with exponential backoff, up to 5 attempts, then report the failure.
- Init first: uploads and downloads require a passing
initvalidation; halt if credentials are invalid. - Remote layout: datasets use
lineage/,data/andmetadata/.
Dependencies
Requires Python 3.8+ (standard library only).
Quick Start
python3 scripts/hf_init.py --validate-only
python3 scripts/hf_download.py --filename data/soul_traces.jsonl --local-dir ./local_data
python3 scripts/hf_upload.py --file lineage/sealed_trace.md --remote-path lineage/sealed_trace.md
Modes
| Mode | Script | Use for | Reference |
|---|---|---|---|
init | scripts/hf_init.py | Validate env vars, test connectivity, create dataset structure | init.md |
download | scripts/hf_download.py | Files, folder snapshots, model weights | download.md |
upload | scripts/hf_upload.py | Files, folders, soul snapshots, JSONL appends | upload.md |
Workflow
- Pick the mode from the table and read its reference.
- Run
init --validate-onlywhen credentials have not been verified this session. - Run the mode's script; follow fallback-tree.md on any failure.
- Confirm the result: files present and non-empty (download), or
HFUploadResult.success(upload).
Verification
python3 scripts/hf_config.py
Check the mode's section in acceptance-criteria.md.
References
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |