What problem does it solve?
This Skill streamlines the process of adding and maintaining evaluation results on Hugging Face model cards, enabling teams to track benchmarks, import external scores, and publish updates via PR workflows.
Core Features & Use Cases
- Extract evaluation tables from README content and convert them into model-index entries.
- Import benchmark scores from Artificial Analysis API and merge with existing results.
- Run custom model evaluations using vLLM or HuggingFace Inference backends for up-to-date benchmarks.
- Automatically generate model-index YAML compatible with model cards and leaderboard integrations.
- Use cases: a team updating a model card after a new evaluation run, or a researcher publishing results with traceable sources.
Quick Start
To start, clone this skill directory into your project and run:
- Preview evaluation extraction: uv run scripts/evaluation_manager.py extract-readme --repo-id "your-username/your-model" --dry-run
- Import AA scores: AA_API_KEY="..." uv run scripts/evaluation_manager.py import-aa --creator-slug "your-organization" --model-name "your-model" --repo-id "your-username/your-model" --create-pr
- Run a local vLLM evaluation: uv run scripts/lighteval_vllm_uv.py --model "model-id" --tasks "leaderboard|mmlu|5" --backend vllm