Official agent skill

Run Evals

by Azure in Azure/azure-sdk-tools

Run evaluation tests for prompt quality. An agent skill from Azure/azure-sdk-tools.

OfficialMITAuto-check passedAI & LLM Engineering

Install Run Evals

skills CLI
$ npx skills add Azure/azure-sdk-tools --skill run-evals -a claude-code

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

GitHub CLI
$ gh skill install Azure/azure-sdk-tools run-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/Azure/azure-sdk-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/run-evals .claude/skills/run-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
run-evals
GitHub stars
134
Token cost
~977 tokens
SKILL.md length
271 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Run evaluation tests for prompt quality. An agent skill from Azure/azure-sdk-tools.

  • Validate prompt changes
  • SKILL.md covers When to Use, Running Evals, Existing Workflows and Recordings, plus 1 more section
  • Calls python
  • Check prompt quality

What it does

Run Evals is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Run evaluation tests for prompt quality. Use for: run evals, validate prompt changes, check prompt quality, eval recording, evaluation failure, debug eval, use recording.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM evaluation. The repository describes itself as: Tools repository leveraged by the Azure SDK team. The licence is MIT.

When your agent uses it

  • Validate prompt changes
  • Check prompt quality
  • Evaluation failure

Example prompts

  • “/run-evals”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6e4fb2b. 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

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Run Evals loads about 977 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 271 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Azure/azure-sdk-tools at commit 6e4fb2b, republished under its MIT licence (© Azure). 271 words, ~977 tokens.

Download SKILL.mdSave it as .claude/skills/run-evals/SKILL.md (or your agent's skills folder).
name
run-evals
description
Run evaluation tests for prompt quality. Use for: run evals, validate prompt changes, check prompt quality, eval recording, evaluation failure, debug eval, use recording.

Run Evaluations

When to Use

  • After modifying any .prompty file to validate quality hasn't regressed
  • Debugging failing or partial eval results
  • Iterating on prompts with cached recordings to avoid LLM costs

Running Evals

Always activate the virtualenv first: .venv\Scripts\activate (Windows) or source .venv/bin/activate (Linux/macOS).

Via CLI
bash
# Run all workflows
avc test eval

# Run a specific workflow
avc test eval --test-paths evals/tests/mention_action

# Run a single test file
avc test eval --test-paths evals/tests/filter_existing_comment/discard_azure_sdk_repeat_comment.yaml

# Multiple runs (median result kept)
avc test eval --num-runs 5 --test-paths evals/tests/filter_comment_metadata

# Use recordings (cached LLM responses) — first run saves, subsequent runs reuse
avc test eval --use-recording --test-paths evals/tests/mention_action

# Verbose output (show passing tests too)
avc test eval --style verbose
Via run.py directly
bash
cd evals
python run.py --test-paths tests/mention_action

Existing Workflows

Workflow directoryKindTarget function in _custom.pyPrompt tested
mention_actionprompt_mention_action_workflowparse_conversation_action.prompty
mention_summarizesummarize_prompt_mention_summarize_workflowsummarize_github_actions.prompty
thread_resolution_actionprompt_thread_resolution_action_workflowparse_thread_resolution_action.prompty
filter_comment_metadataprompt_filter_comment_metadatafilter_comment_with_metadata.prompty
filter_existing_commentprompt_filter_existing_commentfilter_existing_comment.prompty
deduplicate_parser_issueprompt_deduplicate_parser_issuededuplicate_parser_issue.prompty
deduplicate_guidelines_issueprompt_deduplicate_guidelines_issuededuplicate_guidelines_issue.prompty
filter_generic_commentprompt_filter_generic_commentfilter_generic_comment.prompty
judge_comment_confidenceprompt_judge_comment_confidencejudge_comment_confidence.prompty
merge_commentssummarize_prompt_merge_commentsmerge_comments.prompty
generate_correlation_idsprompt_generate_correlation_idsgenerate_correlation_ids.prompty
Evaluator kinds
  • prompt — Action-based. Compares expected vs actual action, then similarity-scores the rationale. Wrong action = 0%.
  • summarize_prompt — Summary-based. Uses SimilarityEvaluator on full output. Success threshold: score > 70%.

Recordings

  • Stored in evals/recordings/<workflow_name>/<testcase_id>.json
  • Gitignored — each dev builds their own cache
  • If you change a test file, delete its recording or run without --use-recording
  • --use-recording on first run makes LLM calls and saves; subsequent runs reuse cached responses

Gotchas

  • Use python cli.py not .\avc: The avc.bat script calls bare python which may resolve to the system Python instead of the venv. Use .venv\Scripts\activate; python cli.py test eval ... to ensure the venv Python is used.
  • Field name mismatch: Test YAML fields must exactly match target function parameter names (excluding testcase and response)
  • Stale recordings: After changing a prompt, delete recordings or run without --use-recording to get fresh results
  • Testcase uniqueness: The testcase field must be unique across all test files in a workflow — it's the cache key
  • Kind validation: The kind in test-config.yaml must be registered in _config_loader.py (prompt or summarize_prompt)

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

Files

Just SKILL.md in packages/python-packages/apiview-copilot/.github/skills/run-evals of Azure/azure-sdk-tools.

Open the folder on GitHubat commit 6e4fb2b

Compare with similar skills

Run 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.

Run Evals compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Evals this skillAzure/azure-sdk-tools134—~977Automated safety check: PassMIT
LLM Benchmarking with lm-evaluation-harnessOrchestra-Research/AI-Research-SKILLs13k8 repos~3kAutomated safety check: PassMIT
Azure AI Projects Python SDKmicrosoft/skills3.1k6 repos~2.8kAutomated safety check: PassMIT
Fine-Tuning ExpertJeffallan/claude-skills12k1 repos~1.7kAutomated safety check: PassMIT
Looperksimback/looper710—~2.7kAutomated safety check: NotesMIT
Hugging Face Local Model Evalshuggingface/skills11k2 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • 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

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub starsUsed in 6 repos~2.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Fine-Tuning Expert

    Jeffallan/claude-skills

    Guides LLM fine-tuning with LoRA and QLoRA through Hugging Face PEFT, from dataset validation and training checks to adapter merging, quantization and deployment.

    12k GitHub starsUsed in 1 repo~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Looper

    ksimback/looper

    Scaffold a well-designed agent loop with best-practice coaching and a cross-model review council.

    710 GitHub stars~2.7k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check: notes
  • 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
  • Agent Eval Engineering

    langchain-ai/langchain-skills

    Official

    Builds agent evaluations in stages: inspect the repository and traces, agree a Task Spec with you, then build, audit and run a Harbor task with an independent verifier.

    1.3k GitHub stars~4k tokensUpdated 3 days ago
    AI & LLM EngineeringAuto-check passed

More from Azure/azure-sdk-tools

All 35 skills in this repo
  • Apiview Feedback Resolution

    Azure/azure-sdk-tools

    Official

    Analyze and resolve APIView review feedback on Azure SDK PRs.

    134 GitHub stars~547 tokensUpdated today
    Auto-check passed
  • Official

    Deploy test resources and run Azure SDK tests in live, record, or playback mode.

    134 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes
  • Azsdk Common Pipeline Analysis

    Azure/azure-sdk-tools

    Official

    Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format.

    134 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Official

    Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.

    134 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Azure Typespec Assessment

    Azure/azure-sdk-tools

    Official

    Assess Azure TypeSpec Git diffs for semantic intent, REST and downstream SDK breaking changes, Azure Guidelines compliance, and documentation completeness.

    134 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about Run Evals

What does Run Evals do?

Run evaluation tests for prompt quality. An agent skill from Azure/azure-sdk-tools. Run Evals is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Run evaluation tests for prompt quality.

When should I use Run Evals?

Run Evals fits situations like: validate prompt changes; check prompt quality; evaluation failure.

How do I install Run Evals in Claude Code?

Run `npx skills add Azure/azure-sdk-tools --skill run-evals -a claude-code`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/run-evals in Azure/azure-sdk-tools) into .claude/skills/run-evals in your project. Claude Code loads it when a task matches its description.

How do I install Run Evals in Codex?

Run `npx skills add Azure/azure-sdk-tools --skill run-evals -a codex`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/run-evals in Azure/azure-sdk-tools) into .agents/skills/run-evals in your project. Codex loads it when a task matches its description.

Can I use Run 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 Azure/azure-sdk-tools --skill run-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/run-evals, .gemini/skills/run-evals, .github/skills/run-evals and .opencode/skills/run-evals in your project.

What does Run Evals need to run?

Going by SKILL.md and its folder, Run Evals needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Run Evals access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Run 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. Review the folder before installing.

What licence does Run Evals use?

Run 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 Run Evals use?

About 977 tokens (SKILL.md is roughly 3.9k 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 Run Evals?

Skills that share tags, products or a category with Run Evals: LLM Benchmarking with lm-evaluation-harness (Orchestra-Research/AI-Research-SKILLs, 13k stars), Azure AI Projects Python SDK (microsoft/skills, 3.1k stars), Fine-Tuning Expert (Jeffallan/claude-skills, 12k stars) and Looper (ksimback/looper, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Evals?

Azure (a GitHub organization, an official publisher) maintains it in Azure/azure-sdk-tools, which has 134 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 8, 2026.

Source: Azure/azure-sdk-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.