Data & Analysis

Hugging Face LLM Trainer

Train, fine-tune, and preserve models on Hugging Face cloud GPUs.

48/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 11k
Last updated
18d ago
License
Apache-2.0
hugging-facemodel-trainingtrlunsloth
+3cloud-gpugguf-conversiontrackio

What does this skill do, and when should you use it?

This skill guides cloud-based training of language and vision-language models with TRL or Unsloth through Hugging Face Jobs. It covers SFT, DPO, GRPO, reward modeling, and post-training GGUF conversion. The guidance includes dataset validation, GPU selection, time and cost estimation, Trackio monitoring, Hub authentication, checkpointing, and model persistence. It is aimed at users who want managed GPU training without setting up local hardware.

It prepares TRL or Unsloth training scripts for supported methods; submits jobs through hf_jobs; configures Trackio, LoRA/PEFT, evaluation, checkpoints, timeouts, and Hub uploads; runs dataset inspection before GPU training; recommends hardware by model size; estimates runtime and cost; and provides scripts and references for converting trained models to GGUF for local inference tools.

Good fit
  • A researcher wants to fine-tune a language model with SFT, DPO, GRPO, or reward modeling without owning a local GPU.
  • An ML engineer needs an asynchronous Hugging Face Jobs workflow with Trackio monitoring, checkpoints, and Hub persistence.
  • A data scientist is preparing a custom DPO dataset and wants to detect column or format mismatches before paying for GPU time.
  • A model developer is training a large model or vision-language model with lower VRAM usage or higher speed through Unsloth.
  • A local deployment builder needs to convert a trained model to GGUF for Ollama, LM Studio, or llama.cpp.

How do you install this skill?

Before you use it
  • Training or conversion submission causes external side effects including cloud-GPU charges, Hub writes, and remote execution; confirm the model, dataset, destination repository, budget, timeout, and permissions before following the immediate-submission directive.
  • HF_TOKEN may grant Hub write access, so the explicit-token examples should not be copied; Trackio Spaces are public by default and may expose sensitive data, prompts, or metrics.
  • The material claims production-tested scripts, but this review was static only and did not verify the TRL, Trackio, Jobs API, GGUF script, or external URLs against current versions.
  • Hugging Face, GitHub, remote dependencies, and dynamic repositories may be affected by network, version, or regional reachability issues; perform a low-cost preflight and prepare cancellation or recovery procedures.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
  • MCP Server
Install first
  • Python
  • uv
  • Hugging Face Jobs
  • TRL
  • Unsloth
  • Trackio

Obtain the skills/huggingface-llm-trainer/ folder from the GitHub repository and copy or symlink it into a Codex-discoverable .agents/skills directory. The README also documents Claude Code installation with /plugin marketplace add huggingface/skills, followed by hf skills add huggingface-llm-trainer. Installation details for other clients are not specified in the source.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/huggingface/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/huggingface-llm-trainer" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

After installation, give the coding agent a concrete request such as: Use the Hugging Face LLM trainer skill to fine-tune Qwen/Qwen2.5-0.5B on my dataset with SFT and save the result to the Hub. For unknown datasets, run the dataset inspector first. For a planned job, define the base model, dataset, GPU flavor, timeout, Hub destination, and a write-enabled HF_TOKEN.

What are this skill's strengths and limitations?

Pros
  • Covers SFT, DPO, GRPO, reward modeling, and GGUF conversion in one workflow.
  • Includes practical guidance for dataset checks, hardware choice, cost estimates, timeouts, and failure recovery.
  • Treats Trackio monitoring, checkpointing, and Hub uploads as core parts of asynchronous training.
  • Offers both standard TRL and Unsloth paths, with several reusable training templates.
Limitations
  • Hugging Face Jobs requires a Pro, Team, or Enterprise paid plan.
  • The workflow depends on cloud GPU access, network connectivity, Hub authentication, and a write-capable token.
  • The source does not document an automated test suite or cross-client validation results for this individual skill.
  • GPU prices and some operational estimates are approximate and may differ from actual runs.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Hugging Face LLM Trainer this page 48 · Use with care ★ 11k 18d ago Apache-2.0
Trackio Experiment Tracking Skill 53 · Use with care ★ 38k 14d ago MIT
Hugging Face Local Evaluator 47 · Use with care ★ 11k 18d ago Apache-2.0
Sentence Transformers Training Assistant 47 · Use with care ★ 11k 18d ago Apache-2.0
Trackio Experiment Tracking 43 · Not recommended ★ 11k 18d ago Apache-2.0

Compared with standard TRL, Unsloth is presented as the better option when VRAM, speed, large models, or vision-language training is the priority. Compared with the trl-jobs one-line package, the UV-script and hf_jobs() approach offers more customization. The source also names TRL-maintained scripts and the Hugging Face Jobs CLI as alternative workflows.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
48/ 100 5-point scale 2.4 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust13 / 25 · 2.6/5

The skill explicitly requires HF_TOKEN via secrets, Hub persistence, and disclosure that Trackio Spaces are public by default and runners are ephemeral, showing partial security awareness. However, it mandates immediate job submission without clear per-action user confirmation, lacks least-privilege guidance and rollback/cancellation procedures, and includes examples using explicit tokens, apt installation, remote scripts, and git clone. External side effects and supply-chain controls are therefore incomplete, warranting deductions.

2Reliability8 / 20 · 2.0/5

The documentation provides preflight checks, timeout guidance, hardware selection, troubleshooting, and recommended error handling, making the conceptual happy path plausible. Static evidence contains no executable scripts, test suite, or CI coverage; several referenced scripts/files are not included in the supplied evidence, and API parameters, versions, and command compatibility remain uncertain. Edge-case behavior and failure feedback are incomplete, so the score is conservatively limited by static calibration.

3Adaptability10 / 15 · 3.3/5

The audience and scenarios—cloud-GPU training, TRL/Unsloth, GGUF conversion, and no-local-GPU workflows—are clearly described, with multiple methods and hardware choices covered. Non-fit boundaries, trigger precision, and environment constraints are less exact; Chinese-language support is not addressed, and core functionality depends on Hugging Face, GitHub, and remote cloud services whose mainland-China reachability is unverified. Deductions reflect that uncertainty.

4Convention7 / 15 · 2.3/5

The material is layered into overview, methods, hardware, Hub persistence, monitoring, and troubleshooting references, with many examples and Apache-2.0 metadata. However, the frontmatter only points to LICENSE.txt, with no clear maintainer, version policy, changelog, or update responsibility. Several referenced scripts/files lack supplied, auditable evidence, and installation and compatibility notes are incomplete, so substantial convention points are deducted.

5Effectiveness6 / 15 · 2.0/5

The skill covers an intended end-to-end workflow from dataset validation through training, monitoring, Hub persistence, and GGUF conversion, which could reduce configuration effort. No representative outputs are verified, users must supply many repository, model, dataset, and environment details, and cost, timing, success-rate, and ‘production-ready’ claims are not established by the supplied static evidence. The result would require meaningful review and adaptation, so the score remains below the static ceiling.

6Verifiability4 / 10 · 2.0/5

The documentation includes concrete commands, configurations, and links to external projects, providing some traceability. It supplies no committed test suite, CI execution evidence, pinned environment, or independently reproducible results; claims such as ‘production tested’ and reported success rates are only assertions within the material. Cross-source corroboration is therefore thin, justifying limited points.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 86cdeee824b7 Review evidence[1][2][3][4][5][6][7][8][9][10]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Do I need a local GPU to use this skill?
No. Its primary workflow uses Hugging Face Jobs cloud GPUs. The repository also documents local execution of utility scripts, but the training workflow is centered on managed infrastructure.
Are training results automatically preserved?
Not by default. Because the Jobs environment is ephemeral, the training configuration should enable `push_to_hub=True`, set `hub_model_id`, and pass `HF_TOKEN` through the job secrets configuration.
What failure modes does it address?
The source specifically discusses dataset-format mismatches, out-of-memory errors, job timeouts, Hub push failures, missing dependencies, and authentication errors. Unknown datasets should be validated before GPU training.

More skills from this repository

All from huggingface/skills

Data & Analysis

Hugging Face Local Evaluator

Run controlled inspect-ai or lighteval evaluations for Hugging Face Hub models on local hardware.

★ 11k FS 47 Use with care 18d ago
Data & Analysis

Sentence Transformers Training Assistant

Train retrieval, similarity, reranking, and sparse-search models with Sentence Transformers.

★ 11k FS 47 Use with care 18d ago
Data & Analysis

Trackio Experiment Tracking

Log, monitor, and query machine-learning experiments with dashboards, diagnostic alerts, and automation-ready output.

★ 11k FS 43 Not recommended 18d ago
Dev & Engineering

Hugging Face ZeroGPU Builder

Build dependable Gradio AI demos and GPU workloads on Hugging Face ZeroGPU.

★ 11k FS 56 Use with care 18d ago
Data & Analysis

Hugging Face Vision Trainer

Train detection, classification, and segmentation models on Hugging Face Jobs GPUs and persist the results to the Hub.

★ 11k FS 43 Not recommended 18d ago
Dev & Engineering

Hugging Face Hub CLI Skill

Give agents command-line control over Hugging Face Hub models, datasets, Spaces, jobs, and infrastructure.

★ 11k FS 42 Not recommended 18d ago
Data & Analysis

Hugging Face Model Finder

Recommends AI models by task, benchmark performance, and available device memory.

★ 11k FS 42 Not recommended 18d ago
Data & Analysis

Hugging Face Dataset Explorer

Explore, query, and extract Hugging Face datasets through the Dataset Viewer API.

★ 11k FS 49 Use with care 18d ago
Dev & Engineering

Hugging Face Paper Research Assistant

Read AI papers and retrieve structured metadata from Hugging Face paper pages.

★ 11k FS 49 Use with care 18d ago
Data & Analysis

TRL Language Model Trainer

Train and fine-tune transformer language models with TRL’s CLI for SFT, preference alignment, and reinforcement learning.

★ 11k FS 48 Use with care 18d ago
Dev & Engineering

Hugging Face Spaces Builder

Build, deploy, debug, and maintain machine-learning apps on Hugging Face Spaces.

★ 11k FS 50 Use with care 18d ago
Dev & Engineering

Hugging Face Local Model Runner

Choose compatible GGUF quantizations from Hugging Face and run them locally with llama.cpp.

★ 11k FS 44 Not recommended 18d ago
Dev & Engineering

Hugging Face MCP Assistant

Connect agents to Hugging Face Hub for searchable models, datasets, documentation, apps, and compute jobs.

★ 11k FS 36 Not recommended 18d ago
Dev & Engineering

LoRA Space Demo Builder

Build and publish a tailored Gradio Space for a Hugging Face LoRA.

★ 11k FS 51 Use with care 18d ago
Data & Analysis

Hugging Face Model Memory Estimator

Estimate inference memory without downloading model weights.

★ 11k FS 44 Not recommended 18d ago
Dev & Engineering

Hugging Face API Tool Builder

Turn Hugging Face API calls into reusable, composable command-line tools.

★ 11k FS 41 Not recommended 18d ago
Writing & Content

Hugging Face Paper Publisher

Publish, connect, and manage research papers on the Hugging Face Hub.

★ 11k FS 36 Not recommended 18d ago
Automation & Ops

SageMaker Deployment Planner

Choose a practical Amazon SageMaker deployment path for your model, traffic pattern, and latency needs.

★ 11k FS 50 Use with care 18d ago
Automation & Ops

SageMaker IAM Preflight

Find and validate a usable SageMaker execution role before deployment or training.

★ 11k FS 41 Not recommended 18d ago
Automation & Ops

AWS Context Discovery

Resolve the active AWS environment before any account operation.

★ 11k FS 50 Use with care 18d ago

Related skills