richfrem/hf-init
plugins/dev-utils/skills/hf-init/SKILL.md
Initialize HuggingFace integration - validates .env variables, tests API connectivity, and ensures the dataset repository structure exists. Use when onboarding a new project to HuggingFace or when credentials change.
$ install --global
skillsauthnpx skillsauth add richfrem/agent-plugins-skills hf-initInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 29, 2026, 5:51 AM287.9s9 files scanned
SKILL.md
- name:
- hf-init
- plugin:
- huggingface-utils
- description:
- Initialize HuggingFace integration - validates .env variables, tests API connectivity, and ensures the dataset repository structure exists. Use when onboarding a new project to HuggingFace or when credentials change.
- allowed-tools:
- Bash, Read
Dependencies
This skill requires Python 3.8+ and standard library only. No external packages needed.
To install this skill's dependencies:
pip-compile ./requirements.in
pip install -r ./requirements.txt
See ./requirements.txt for the dependency lockfile (currently empty — standard library only).
HuggingFace Init (Onboarding)
Status: Active Author: Richard Fremmerlid Domain: HuggingFace Integration
Purpose
Sets up everything needed for HuggingFace persistence. Run this once when onboarding a new project, or whenever credentials change.
What It Does
- Validates required
.envvariables are set - Tests API connectivity with the configured token
- Ensures the dataset repository exists on HF Hub
- Creates the standard folder structure (
lineage/,data/,metadata/) - Uploads the dataset card (README.md) with configurable discovery tags
Required Environment Variables
| Variable | Required | Description |
|:---------|:---------|:------------|
| HUGGING_FACE_USERNAME | ✅ Yes | Your HF username |
| HUGGING_FACE_TOKEN | ✅ Yes | API token (set in ~/.zshrc, NOT .env) |
| HUGGING_FACE_REPO | ✅ Yes | Model repo name |
| HUGGING_FACE_DATASET_PATH | ✅ Yes | Dataset repo name |
| HUGGING_FACE_TAGS | ❌ No | Comma-separated discovery tags for dataset card |
| HUGGING_FACE_PROJECT_NAME | ❌ No | Pretty name for dataset card heading |
| SOUL_VALENCE_THRESHOLD | ❌ No | Moral/emotional charge filter (default: -0.7) |
Usage
Validate Config
python ./hf_config.py
Full Init (Validate + Create Structure + Dataset Card)
python ./hf_init.py
Validate Only (No Changes)
python ./hf_init.py --validate-only
Quick Setup
# Token goes in shell profile (never committed):
export HUGGING_FACE_TOKEN=hf_xxxxxxxxxxxxx
# Project vars go in .env:
HUGGING_FACE_USERNAME=<your-username>
HUGGING_FACE_REPO=<your-model-repo>
HUGGING_FACE_DATASET_PATH=<your-dataset-repo>
# Optional customization:
HUGGING_FACE_TAGS=reasoning-traces,cognitive-continuity,your-project-tag
HUGGING_FACE_PROJECT_NAME=My Project Soul
# Run init
python ./hf_init.py
Related Skills
richfrem/issue-worktree-agent
testing
VerifiedTrustedCommunity
Skill for creating and managing isolated git worktrees (`.worktrees/issue-NNN`) for issue execution branches. USE ONLY when setting up or cleaning up isolated git worktrees for specific issue execution. DO NOT USE for managing local task files (use `task-agent`) or escalating tasks to issues (use `github-issue-backlog-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/issue-pr-lifecycle-agent
data-ai
VerifiedTrustedCommunity
Skill for orchestrating the end-to-end GitHub issue lifecycle flow: Issue -> Worktree -> Implementation -> PR Creation -> Resolution Closure. USE ONLY when running or dry-running full lifecycle orchestration for resolving an issue with a PR. DO NOT USE for isolated worktree management only (use `issue-worktree-agent`) or logging issues (use `github-issue-agent`).
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-prioritizer
tools
VerifiedTrustedCommunity
Automatically ranks GitHub issues (P0-P3) based on friction tier, frequency, and blockages, synchronizing priority labels and GitHub Projects v2 custom fields.
4SKILL.mdUpdated Jul 29, 2026
richfrem/github-issue-backlog-agent
testing
VerifiedTrustedCommunity
Bridge skill for escalating ephemeral local task scratchpad items (`tasks/*.md`) into durable, taxonomy-validated, evidence-rich GitHub Issues. USE ONLY when promoting a single-session local task into durable repository backlog. DO NOT USE for managing local kanban boards (use `task-agent` instead) or directly querying/commenting on issues (use `github-issue-agent` instead).
4SKILL.mdUpdated Jul 29, 2026