hugging-face-evaluation

Convert README evaluation tables into Hugging Face model-index format.

10.9k|724|Updated Nov 24, 2025
One-click install
npx skills add https://github.com/huggingface/skills --skill hugging-face-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hugging-face-evaluation
Source: https://github.com/huggingface/skills/tree/main/skills/hugging-face-evaluation
Command: npx skills add https://github.com/huggingface/skills --skill hugging-face-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires huggingface-hub, markdown-it-py, python-dotenv, pyyaml, requests, and includes scripts (resource) components.

What problem does it solve?

This Skill centralizes and streamlines the process of recording, updating, and validating evaluation results for Hugging Face model cards by converting README-stored scores and API-sourced benchmarks into a standardized model-index format.

Core Features & Use Cases

  • Read README evaluation tables and convert them into model-index entries for display in the model card widget.
  • Import benchmark scores from Artificial Analysis and merge them with existing evaluations.
  • Run custom model evaluations using vLLM or lighteval for GPU-backed workflows and then push updates via PRs or direct commits.

Quick Start

  1. Inspect a model README to identify tables: uv run scripts/evaluation_manager.py inspect-tables --repo-id <owner>/<model>.
  2. Extract a specific table to YAML: uv run scripts/evaluation_manager.py extract-readme --repo-id <owner>/<model> --table 1 --task-type "text-generation" --apply.
  3. Or import Artificial Analysis evaluations: AA_API_KEY=... uv run scripts/evaluation_manager.py import-aa --creator-slug <creator> --model-name <model> --repo-id <owner>/<model> --create-pr

Frequently Asked Questions about hugging-face-evaluation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert README evaluation tables to Hugging Face model-index format?

To convert README evaluation tables to Hugging Face model-index format, inspect the model repository's README to identify tables, extract the desired table to YAML using the task type, and apply the changes to generate validated model-index entries for the model card widget.

Can I import Artificial Analysis benchmark scores into a Hugging Face model card?

Yes, you can import Artificial Analysis benchmark scores into a Hugging Face model card by providing your AA_API_KEY and creator slug, fetching the evaluations, and using the import command to merge them with existing model-index data via a pull request.

Does this skill support running custom model evaluations with vLLM or lighteval?

Yes, the skill supports running custom model evaluations using vLLM or lighteval for GPU-backed workflows, allowing you to generate new benchmark scores and automatically push the updated evaluation results to model cards via pull requests or direct commits.

What is the best way to automate pull-request updates for Hugging Face model cards?

The best way to automate pull-request updates for Hugging Face model cards is to use a script that extracts README evaluations or imports Artificial Analysis data, converts it to model-index format, and submits the validated changes directly to the repository via a PR.

Do I need an API key to import Artificial Analysis evaluations into model cards?

Yes, you need an AA_API_KEY to import Artificial Analysis evaluations into model cards, which authorizes the script to fetch benchmark scores for your specific creator slug and model name before merging them into the Hugging Face model-index format.

How does validating model-index format improve Hugging Face model card updates?

Validating the model-index format ensures that README-stored scores and API-sourced benchmarks are correctly transformed into standardized entries, preventing format errors and enabling seamless, automated updates to Hugging Face model cards without manual correction.