hugging-face-evaluation-manager

Extract README evaluation tables into model-index YAML for Hugging Face model cards.

2|2|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/patronus-ai/skill-inject --skill hugging-face-evaluation-manager-patronus-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hugging-face-evaluation-manager
Source: https://github.com/patronus-ai/skill-inject/tree/main/data/skills/hf_model_evaluation
Command: npx skills add https://github.com/patronus-ai/skill-inject --skill hugging-face-evaluation-manager-patronus-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Adding or updating benchmark results on Hugging Face model cards is time-consuming and error-prone, especially when evaluations exist as README tables or need to be imported from external sources.

Core Features & Use Cases

  • Extract eval tables from README and convert them into compliant model-index YAML for leaderboard visibility.
  • Import benchmark scores from Artificial Analysis and merge them into existing model card metadata.
  • Run evaluations on HF Jobs using inspect-ai (inference-provider style) or run custom evaluations locally/on jobs with vLLM or lighteval for GPU throughput.

Quick Start

Ask the AI to extract an evaluation table from your model README and print the resulting model-index YAML for review.

Frequently Asked Questions about hugging-face-evaluation-manager

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

FAQPage Schema
How do I update Hugging Face model cards with benchmark evaluation results?

You can update Hugging Face model cards by extracting README markdown evaluation tables or importing scores from Artificial Analysis, then converting them into model-index YAML metadata. This integrates benchmark results directly into the HF Hub for leaderboard and Papers with Code compatibility.

How do I convert markdown evaluation tables into model-index YAML for Hugging Face?

Converting markdown evaluation tables into model-index YAML for Hugging Face involves parsing the README tables and generating compliant metadata. This allows the evaluation metrics to be recognized by Hugging Face leaderboards and Papers with Code.

Can I run inspect-ai and vLLM evaluations through Hugging Face Jobs?

Yes, you can run inspect-ai and vLLM or lighteval evaluations through Hugging Face Jobs using uv. This allows you to submit evaluation scripts for GPU throughput and automatically integrate the results into your model card maintenance workflow.

Do I need an HF_TOKEN or AA_API_KEY to import scores from Artificial Analysis to Hugging Face?

Yes, importing scores from Artificial Analysis and writing to the Hugging Face Hub requires integrating HF_TOKEN for Hub writes and AA_API_KEY for Artificial Analysis access. These environment variables authenticate the automated metadata updates.

What is the best way to automate Hugging Face model card maintenance for multiple evaluation runs?

The best way to automate Hugging Face model card maintenance is by using a workflow that extracts benchmark tables, generates model-index YAML, and submits inspect-ai or vLLM evaluation scripts through HF Jobs. This handles inspection, validation, and job-based runs automatically.

Does updating model-index metadata work with both local vLLM runs and remote HF Jobs?

Yes, updating model-index metadata works with both local vLLM or lighteval runs and remote HF Jobs. The workflow parses the resulting evaluation metrics and merges them into existing model card metadata regardless of the execution environment.