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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| evals/evals.json | config | 2.1 KB |
| references/acceptance-criteria.md | markdown | 2.2 KB |
| references/download.md | markdown | 1.7 KB |
| references/fallback-tree.md | markdown | 3.4 KB |
| references/init.md | markdown | 1.4 KB |
| references/upload.md | markdown | 2.1 KB |
| scripts/hf_config.py | script | 6.2 KB |
| scripts/hf_download.pyexecutable | script | 6.5 KB |
| scripts/hf_init.py | script | 2.7 KB |
| scripts/hf_upload.py | script | 13.2 KB |
references/init.md
View on GitHub# HuggingFace setup and validation (`init` mode)
Sets up credentials, connectivity, and dataset repository structure for HuggingFace persistence.
## Critical Constraints
1. **Secret Hygiene**: Tokens must be stored in shell profile (`~/.zshrc`), NEVER committed to `.env` or Git.
2. **Repository Structure**: Enforces standard folder structure (`lineage/`, `data/`, `metadata/`).
## Quick start
Validate HuggingFace configuration without modifying remote repositories:
```bash
python3 scripts/hf_init.py --validate-only
```
## Required Environment Variables
| Variable | Required | Description |
|---|---|---|
| `HUGGING_FACE_USERNAME` | Yes | HuggingFace account username |
| `HUGGING_FACE_TOKEN` | Yes | Hub API token (in shell profile) |
| `HUGGING_FACE_REPO` | Yes | Model repository name |
| `HUGGING_FACE_DATASET_PATH` | Yes | Dataset repository name |
| `HUGGING_FACE_TAGS` | No | Comma-separated discovery tags |
| `HUGGING_FACE_PROJECT_NAME` | No | Display name for dataset card |
## Workflow
1. **Credential Validation**: Verify presence of required environment variables.
2. **Connectivity Test**: Run API probe to confirm read/write token privileges.
3. **Repository Setup**: Initialize standard directory structure (`lineage/`, `data/`, `metadata/`) on remote dataset.
4. **Readiness Report**: Output connection status and configured paths.
## Verification
Confirm configuration and authentication validity:
```bash
python3 scripts/hf_config.py
```
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 |