llm-evaluation-selftest.py - Validate all scripts work
Details: See LLM_EVALUATION_SCRIPTS.md for parameters and examples
Key Findings
Judge model recommendation: Use gpt-5-mini for LLM-as-judge tasks (best calibration on similarity tests)
Worker limits (2026-01-26):
OpenAI models: 120+ concurrent workers
Anthropic models: 60+ concurrent workers
Claude model IDs: Use exact release dates (e.g., claude-opus-4-5-20251101 not 20250514). See LLM_EVALUATION_CLAUDE_MODELS.md for verified IDs.
Tested models: 16+ models validated via llm-evaluation-selftest.py. See LLM_EVALUATION_TESTED_MODELS.md for full list.
1---2name: llm-evaluation3description: LLM Evaluation Skill4---5# LLM Evaluation Skill67Evaluate LLM performance through structured testing pipelines.89## When to Use This Skill1011**Apply when:**12- Testing LLM transcription accuracy (images → text)13- Comparing multiple LLM outputs for quality14- Measuring model performance with LLM-as-judge15- Analyzing API costs across models16- Finding optimal concurrency limits for API calls17- Running batch evaluations with parallel workers1819**Do NOT apply when:**20- Making single ad-hoc LLM calls (use API directly)21- Testing non-LLM systems22- Simple file processing without LLM involvement2324## Quick Start25261. Run `SETUP.md` once to install dependencies272. Choose your workflow:28 - **Single call**: `call-llm.py` for one-off tests29 - **Batch processing**: `call-llm-batch.py` for multiple files30 - **Full pipeline**: Transcribe → Questions → Answers → Evaluate31 - **Worker limits**: `find-workers-limit.py` to find max concurrency32 - **Cost analysis**: `analyze-costs.py` for token usage reports3334## Available Scripts3536**Core Scripts:**37- `call-llm.py` - Single LLM API call38- `call-llm-batch.py` - Batch processing with parallel workers39- `find-workers-limit.py` - Discover max concurrent workers4041**Evaluation Pipeline:**42- `generate-questions.py` - Create test questions from source43- `generate-answers.py` - Generate answers from processed text44- `evaluate-answers.py` - Score answers with LLM judge45- `compare-transcription-runs.py` - Compare outputs (Levenshtein/semantic)4647**Analysis:**48- `analyze-costs.py` - Calculate token costs49- `llm-evaluation-selftest.py` - Validate all scripts work5051**Details:** See `LLM_EVALUATION_SCRIPTS.md` for parameters and examples5253## Key Findings5455**Judge model recommendation:** Use `gpt-5-mini` for LLM-as-judge tasks (best calibration on similarity tests)5657**Worker limits (2026-01-26):**58- OpenAI models: 120+ concurrent workers59- Anthropic models: 60+ concurrent workers6061**Claude model IDs:** Use exact release dates (e.g., `claude-opus-4-5-20251101` not `20250514`). See `LLM_EVALUATION_CLAUDE_MODELS.md` for verified IDs.6263**Tested models:** 16+ models validated via `llm-evaluation-selftest.py`. See `LLM_EVALUATION_TESTED_MODELS.md` for full list.64
Run npx skillmds@latest add karstenheld3/llm-evaluation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
LLM Evaluation Skill It is listed under AI & ML on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
karstenheld3 (@karstenheld3) published this skill. Their other Agent Skills are listed on their SkillMD profile.