Agent skill

Hugging Face Community Evals

by henryalouf in henryalouf/ruflow

Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

MITAuto-check passedAI & LLM Engineering

Install Hugging Face Community Evals

skills CLI
$ npx skills add henryalouf/ruflow --skill hugging-face-community-evals -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install henryalouf/ruflow hugging-face-community-evals --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/henryalouf/ruflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/hugging-face-community-evals .claude/skills/hugging-face-community-evals && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hugging-face-community-evals
GitHub stars
157
Token cost
~1.6k tokens
SKILL.md length
703 words
Files
6 (incl. scripts)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

  • Works in 5 steps: Choose the evaluation framework. → Choose the inference backend. → Start with a smoke test. → …
  • Tasks that involve Model hubs and datasets
  • SKILL.md covers When to Use, Option A: inspect-ai with…, Option B: inspect-ai on Local… and Option C: lighteval on Local GPU
  • Runs Python scripts from its folder; calls uv; needs HF_TOKEN

What it does

Hugging Face Community Evals is an agent skill from henryalouf/ruflow. Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts (for example `examples/USAGE_EXAMPLES.md`, `scripts/inspect_eval_uv.py` and `scripts/inspect_vllm_uv.py`).

It sits in AI & LLM Engineering, covering Model hubs and datasets and LLM evaluation. It works with Hugging Face and vLLM. The licence is MIT.

When your agent uses it

  • Tasks that involve Model hubs and datasets
  • Tasks that involve LLM evaluation

Example prompts

  • “/hugging-face-community-evals”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Choose the evaluation framework.
  2. Choose the inference backend.
  3. Start with a smoke test.
  4. Scale up only after the smoke test passes.
  5. If the user wants remote execution, hand off to hugging-face-jobs with the same script + args.

What it can do on your machine

Read from SKILL.md and the folder at commit 568d7a5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HF_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hugging Face Community Evals loads about 1.6k tokens when it runs. Until then it costs about 27 tokens; SKILL.md has 703 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~27
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from henryalouf/ruflow at commit 568d7a5, republished under its MIT licence (© henryalouf). 703 words, ~1,646 tokens.

Download SKILL.mdSave it as .claude/skills/hugging-face-community-evals/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
hugging-face-community-evals
description
Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.
source
https://github.com/huggingface/skills/tree/main/skills/huggingface-community-evals
risk
unknown

Overview

When to Use

Use this skill for local model evaluation, backend selection, and GPU smoke tests outside the Hugging Face Jobs workflow.

This skill is for running evaluations against models on the Hugging Face Hub on local hardware.

It covers:

  • inspect-ai with local inference
  • lighteval with local inference
  • choosing between vllm, Hugging Face Transformers, and accelerate
  • smoke tests, task selection, and backend fallback strategy

It does not cover:

  • Hugging Face Jobs orchestration
  • model-card or model-index edits
  • README table extraction
  • Artificial Analysis imports
  • .eval_results generation or publishing
  • PR creation or community-evals automation

If the user wants to run the same eval remotely on Hugging Face Jobs, hand off to the hugging-face-jobs skill and pass it one of the local scripts in this skill.

If the user wants to publish results into the community evals workflow, stop after generating the evaluation run and hand off that publishing step to ~/code/community-evals.

All paths below are relative to the directory containing this SKILL.md.

When To Use Which Script

Use caseScript
Local inspect-ai eval on a Hub model via inference providersscripts/inspect_eval_uv.py
Local GPU eval with inspect-ai using vllm or Transformersscripts/inspect_vllm_uv.py
Local GPU eval with lighteval using vllm or acceleratescripts/lighteval_vllm_uv.py
Extra command patternsexamples/USAGE_EXAMPLES.md

Prerequisites

  • Prefer uv run for local execution.
  • Set HF_TOKEN for gated/private models.
  • For local GPU runs, verify GPU access before starting:
bash
uv --version
printenv HF_TOKEN >/dev/null
nvidia-smi

If nvidia-smi is unavailable, either:

  • use scripts/inspect_eval_uv.py for lighter provider-backed evaluation, or
  • hand off to the hugging-face-jobs skill if the user wants remote compute.

Core Workflow

  1. Choose the evaluation framework.
    • Use inspect-ai when you want explicit task control and inspect-native flows.
    • Use lighteval when the benchmark is naturally expressed as a lighteval task string, especially leaderboard-style tasks.
  2. Choose the inference backend.
    • Prefer vllm for throughput on supported architectures.
    • Use Hugging Face Transformers (--backend hf) or accelerate as compatibility fallbacks.
  3. Start with a smoke test.
    • inspect-ai: add --limit 10 or similar.
    • lighteval: add --max-samples 10.
  4. Scale up only after the smoke test passes.
  5. If the user wants remote execution, hand off to hugging-face-jobs with the same script + args.

Quick Start

Option A: inspect-ai with local inference providers path

Best when the model is already supported by Hugging Face Inference Providers and you want the lowest local setup overhead.

bash
uv run scripts/inspect_eval_uv.py \
  --model meta-llama/Llama-3.2-1B \
  --task mmlu \
  --limit 20

Use this path when:

  • you want a quick local smoke test
  • you do not need direct GPU control
  • the task already exists in inspect-evals

Option B: inspect-ai on Local GPU

Best when you need to load the Hub model directly, use vllm, or fall back to Transformers for unsupported architectures.

Local GPU:

bash
uv run scripts/inspect_vllm_uv.py \
  --model meta-llama/Llama-3.2-1B \
  --task gsm8k \
  --limit 20

Transformers fallback:

bash
uv run scripts/inspect_vllm_uv.py \
  --model microsoft/phi-2 \
  --task mmlu \
  --backend hf \
  --trust-remote-code \
  --limit 20
Show full SKILL.md (273 more words)Show less

Option C: lighteval on Local GPU

Best when the task is naturally expressed as a lighteval task string, especially Open LLM Leaderboard style benchmarks.

Local GPU:

bash
uv run scripts/lighteval_vllm_uv.py \
  --model meta-llama/Llama-3.2-3B-Instruct \
  --tasks "leaderboard|mmlu|5,leaderboard|gsm8k|5" \
  --max-samples 20 \
  --use-chat-template

accelerate fallback:

bash
uv run scripts/lighteval_vllm_uv.py \
  --model microsoft/phi-2 \
  --tasks "leaderboard|mmlu|5" \
  --backend accelerate \
  --trust-remote-code \
  --max-samples 20

Remote Execution Boundary

This skill intentionally stops at local execution and backend selection.

If the user wants to:

  • run these scripts on Hugging Face Jobs
  • pick remote hardware
  • pass secrets to remote jobs
  • schedule recurring runs
  • inspect / cancel / monitor jobs

then switch to the hugging-face-jobs skill and pass it one of these scripts plus the chosen arguments.

Task Selection

inspect-ai examples:

  • mmlu
  • gsm8k
  • hellaswag
  • arc_challenge
  • truthfulqa
  • winogrande
  • humaneval

lighteval task strings use suite|task|num_fewshot:

  • leaderboard|mmlu|5
  • leaderboard|gsm8k|5
  • leaderboard|arc_challenge|25
  • lighteval|hellaswag|0

Multiple lighteval tasks can be comma-separated in --tasks.

Backend Selection

  • Prefer inspect_vllm_uv.py --backend vllm for fast GPU inference on supported architectures.
  • Use inspect_vllm_uv.py --backend hf when vllm does not support the model.
  • Prefer lighteval_vllm_uv.py --backend vllm for throughput on supported models.
  • Use lighteval_vllm_uv.py --backend accelerate as the compatibility fallback.
  • Use inspect_eval_uv.py when Inference Providers already cover the model and you do not need direct GPU control.

Hardware Guidance

Model sizeSuggested local hardware
< 3Bconsumer GPU / Apple Silicon / small dev GPU
3B - 13Bstronger local GPU
13B+high-memory local GPU or hand off to hugging-face-jobs

For smoke tests, prefer cheaper local runs plus --limit or --max-samples.

Troubleshooting

  • CUDA or vLLM OOM:
    • reduce --batch-size
    • reduce --gpu-memory-utilization
    • switch to a smaller model for the smoke test
    • if necessary, hand off to hugging-face-jobs
  • Model unsupported by vllm:
    • switch to --backend hf for inspect-ai
    • switch to --backend accelerate for lighteval
  • Gated/private repo access fails:
    • verify HF_TOKEN
  • Custom model code required:
    • add --trust-remote-code

Examples

See:

  • examples/USAGE_EXAMPLES.md for local command patterns
  • scripts/inspect_eval_uv.py
  • scripts/inspect_vllm_uv.py
  • scripts/lighteval_vllm_uv.py

© henryalouf, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in .agents/skills/hugging-face-community-evals of henryalouf/ruflow.

  • SKILL.md
  • examples/.env.example
  • examples/USAGE_EXAMPLES.md
  • scripts/inspect_eval_uv.py
  • scripts/inspect_vllm_uv.py
  • scripts/lighteval_vllm_uv.py

Open the folder on GitHubat commit 568d7a5

Compare with similar skills

Hugging Face Community Evals next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hugging Face Community Evals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hugging Face Community Evals this skillhenryalouf/ruflow157—~1.6kAutomated safety check: PassMIT
Hugging Face Local Model Evalshuggingface/skills11k2 repos~1.6kAutomated safety check: PassApache-2.0
Hugging Face Community Evalssickn33/agentic-awesome-skills47k1 repos~1.9kAutomated safety check: PassApache-2.0
Huggingface Community Evalssickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: PassMIT
LLM Benchmarking with lm-evaluation-harnessOrchestra-Research/AI-Research-SKILLs13k8 repos~3kAutomated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0

Similar skills

  • Official

    Runs evaluations of Hugging Face Hub models on local hardware with inspect-ai or lighteval, and helps choose between vLLM, Transformers and accelerate backends.

    11k GitHub starsUsed in 2 repos~1.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Hugging Face Community Evals

    sickn33/agentic-awesome-skills

    Run evaluations for Hugging Face Hub models using inspect-ai and lighteval on local hardware.

    47k GitHub starsUsed in 1 repo~1.9k tokens
    AI & LLM EngineeringAuto-check passed
  • Huggingface Community Evals

    sickn33/agentic-awesome-skills

    Curated upstream guidance for Huggingface Community Evals; use when the workflow matches the user goal.

    47k GitHub starsUsed in 1 repo~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • LLM Benchmarking with lm-evaluation-harness

    Orchestra-Research/AI-Research-SKILLs

    Runs lm-evaluation-harness to benchmark language models on academic suites such as MMLU, GSM8K and HumanEval, compare models and track training checkpoints.

    13k GitHub starsUsed in 8 repos~3k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Add Model

    guoqingbao/xinfer

    Adapt and port new LLM model architectures to this xinfer project.

    334 GitHub stars~4.2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check: notes

More from henryalouf/ruflow

All 13 skills in this repo
  • Agents Md

    henryalouf/ruflow

    This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Claimable Postgres

    henryalouf/ruflow

    Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new).

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check: notes
  • Train or fine-tune TRL language models on Hugging Face Jobs, including SFT, DPO, GRPO, and GGUF export.

    157 GitHub stars~6.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Train or fine-tune vision models on Hugging Face Jobs for detection, classification, and SAM or SAM2 segmentation.

    157 GitHub stars~7.4k tokensUpdated 4 mo ago
    Auto-check passed
  • SEO Aeo Blog Writer

    henryalouf/ruflow

    Writes long-form blog posts with TL;DR block, definition sentence, comparison table, and 5-question FAQ for SEO ranking and AEO citation.

    157 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • SEO Aeo Content Cluster

    henryalouf/ruflow

    Builds a topical authority map with a pillar page, prioritised cluster articles, content types, internal link map, and content gap analysis.

    157 GitHub stars~954 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Hugging Face Community Evals

What does Hugging Face Community Evals do?

Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval. Hugging Face Community Evals is an agent skill from henryalouf/ruflow. Run local evaluations for Hugging Face Hub models with inspect-ai or lighteval.

When should I use Hugging Face Community Evals?

Hugging Face Community Evals fits situations like: tasks that involve Model hubs and datasets; tasks that involve LLM evaluation.

How do I install Hugging Face Community Evals in Claude Code?

Run `npx skills add henryalouf/ruflow --skill hugging-face-community-evals -a claude-code`. Or copy the skill folder (.agents/skills/hugging-face-community-evals in henryalouf/ruflow) into .claude/skills/hugging-face-community-evals in your project. Claude Code loads it when a task matches its description.

How do I install Hugging Face Community Evals in Codex?

Run `npx skills add henryalouf/ruflow --skill hugging-face-community-evals -a codex`. Or copy the skill folder (.agents/skills/hugging-face-community-evals in henryalouf/ruflow) into .agents/skills/hugging-face-community-evals in your project. Codex loads it when a task matches its description.

Can I use Hugging Face Community Evals in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add henryalouf/ruflow --skill hugging-face-community-evals -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hugging-face-community-evals, .gemini/skills/hugging-face-community-evals, .github/skills/hugging-face-community-evals and .opencode/skills/hugging-face-community-evals in your project.

What does Hugging Face Community Evals need to run?

Going by SKILL.md and its folder, Hugging Face Community Evals needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named HF_TOKEN. Our summary lists: Python 3.

Does Hugging Face Community Evals access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Hugging Face Community Evals safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Hugging Face Community Evals use?

Hugging Face Community Evals is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hugging Face Community Evals use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hugging Face Community Evals?

Skills that share tags, products or a category with Hugging Face Community Evals: Hugging Face Local Model Evals (huggingface/skills, 11k stars), Hugging Face Community Evals (sickn33/agentic-awesome-skills, 47k stars), Huggingface Community Evals (sickn33/agentic-awesome-skills, 47k stars) and LLM Benchmarking with lm-evaluation-harness (Orchestra-Research/AI-Research-SKILLs, 13k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hugging Face Community Evals?

henryalouf (a GitHub user) maintains it in henryalouf/ruflow, which has 157 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on May 18, 2026.

Source: henryalouf/ruflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.