skill-evaluation SKILL.md skillA

skill-evaluation from fabricioctelles/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add fabricioctelles/skills/skill-evaluation@v2.1.0

Pins v2.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
fabricioctelles/skills
Path
skills/skill-evaluation/SKILL.md
Versions recorded
5
Latest version
v2.1.0, committed Jul 18, 2026
First version recorded
Jun 27, 2026
Size
15,341 bytes
Repository stars
132
License
Apache-2.0

Evaluate any agent skill against a merged framework — Anthropic's Claude Code best practices plus Matt Pocock's writing-great-skills methodology — across 4 axes (Trigger, Structure, Steering, Pruning). Produces an evidence-cited scorecard (0–100), a weighted overall score, and diagnosed failure modes with prioritized fixes. Use when the user asks to evaluate, rate, or audit a skill ("evaluate this skill", "skill scorecard", "review SKILL.md"), or to compare two skills.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Skill Evaluation

If you need the vocabulary and tests behind Axes 1, 3, and 4 (leading words,
completion criteria, context pointers, the deletion test, failure-mode
definitions), read `references/mechanics.md` before scoring those axes.

## Source

- [Lessons from building Claude Code: How we use skills](https://claude.com/blog/lessons-from-building-claude-code-how-we-use-skills) — Anthropic, Jun 2026
- "The Missing Manual: How to Write Great Skills" — Matt Pocock, AI Engineer World's Fair 2026 ([video](https://www.youtube.com/watch?v=UNzCG3lw6O0)), and his `writing-great-skills` skill

## Parameters

| Parameter | Description | Default |
|-----------|-------------|---------|
| `target` | Path to skill directory or SKILL.md to evaluate | Ask user |
| `output` | Path to write the scorecard | `<target>/EVALUATION.md` |
| `compare` | Optional second skill to compare side-by-side | None |

Also runs unattended: in CI, point `target` at skills changed in a PR and
gate with `scripts/score.py --fail-below 60 ...` — non-zero exit below the
threshold fails the check.

## Criteria

18 criteria: 14 core, scored on every skill, plus 4 conditional criteria
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add fabricioctelles/skills/skill-evaluation@sha256:46e7d591cc47e6ae

The line at the top of this page pins the label v2.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mfo7frfjoinjnot7.svg)](https://markdownregistry.com/a/art_mfo7frfjoinjnot7)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jun 27, 2026 and Jul 18, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v2.1.0 latest2026-07-18 5a40a1b 15,341 BA view · diff
v2.1.02026-07-04 5ed3059 12,126 BA view · diff
v2.0.02026-07-03 28488ca 16,183 BA view · diff
v1.0.02026-07-02 7f9526a 8,500 BA view · diff
v1.0.02026-06-27 5c00e0c 8,498 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15341 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

fabricioctelles/skills · 132 stars · license Apache-2.0 · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mfo7frfjoinjnot7
GET https://markdownregistry.com/api/v1/resolve?ref=fabricioctelles/skills/skill-evaluation
GET https://markdownregistry.com/api/v1/blob/46e7d591cc47e6ae921527ac779d0e7b41d9106777692a6c624d8f7cb541254b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from fabricioctelles/skills

human-ai SKILL.md skill
fabricioctelles/skills · plugins/deslop-writing/skills/human-ai/SKILL.md · Edit English prose to remove repetitive AI phrasing, inflated language, and mechanical structure while preserving…
git:20261011.242512d · audit A · 132 stars
humanizar SKILL.md skill
fabricioctelles/skills · plugins/deslop-writing/skills/humanizar/SKILL.md · Write and edit Brazilian Portuguese prose with natural rhythm and the author's voice while preserving facts, meaning…
git:20261011.242512d · audit A · 132 stars
agent-plugin-eval SKILL.md skill
fabricioctelles/skills · skills/agent-plugin-eval/SKILL.md · Audit, score, and compare repositories containing portable Agent Plugins against the official Agent Plugins…
git:20260918.8b2febf · audit A · 132 stars
agent-ready-cloudflare SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/SKILL.md · Audit and improve website readiness for AI agents using the Cloudflare "Is It Agent Ready?" scanner…
v3.3 · audit A · 132 stars
agent-ready-a2a-agent-card SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/a2a-agent-card/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement A2A Agent Card
git:20260716.c5d769e · audit A · 132 stars
agent-ready-acp SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/acp/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement ACP Discovery Document
git:20260716.c5d769e · audit A · 132 stars
agent-ready-agent-skills SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/agent-skills/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement Agent Skills Discovery Index
git:20260716.c5d769e · audit A · 132 stars
agent-ready-ai-rules SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/ai-rules/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement AI Bot Rules in robots.txt
git:20261029.544f888 · audit A · 132 stars
agent-ready-api-catalog SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/api-catalog/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement API Catalog
git:20260716.c5d769e · audit A · 132 stars
agent-ready-ard SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/ard/SKILL.md · Sub-skill: Implement ARD (Agentic Resource Discovery). Publish /.well-known/ai-catalog.json so agents can discover MCP…
git:20260918.bc4f8f7 · audit A · 132 stars
agent-ready-auth-md SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/auth-md/SKILL.md · Sub-skill: Implement Auth.md for agent registration discovery. Serve /auth.md with OAuth metadata at…
git:20260918.bc4f8f7 · audit A · 132 stars
agent-ready-content-signals SKILL.md skill
fabricioctelles/skills · skills/agent-ready-cloudflare/content-signals/SKILL.md · Sub-skill de agent-ready-cloudflare: Implement Content Signals
git:20260716.c5d769e · audit A · 132 stars

Every file in fabricioctelles/skills

Other files named skill-evaluation

skill-evaluation SKILL.md skill
naodeng/awesome-qa-skills · skills/en/skill-engineering/skill-evaluation/SKILL.md · Use this skill when designing, running, interpreting, or reporting Agent Skill evaluations, selecting cases or judges…
v1.0.0 · audit A · 301 stars
skill-evaluation SKILL.md skill
naodeng/awesome-qa-skills · skills/zh/skill-engineering/skill-evaluation/SKILL.md · Use this skill when designing, running, interpreting, or reporting Agent Skill evaluations, selecting cases or judges…
v1.0.0 · audit A · 301 stars
skill-evaluation SKILL.md skill
naodeng/awesome-qa-skills · evidence/skill-quality/2026-10-03-codex-pilot/reproduction/packages/skill-evaluation-en/SKILL.md · Use this skill when designing, running, interpreting, or reporting Agent Skill evaluations, selecting cases or judges…
git:20261016.61d7e3c · audit A · 301 stars
skill-evaluation SKILL.md skill
naodeng/awesome-qa-skills · evidence/skill-quality/2026-10-03-codex-pilot/reproduction/packages/skill-evaluation-zh/SKILL.md · Use this skill when designing, running, interpreting, or reporting Agent Skill evaluations, selecting cases or judges…
git:20261016.61d7e3c · audit A · 301 stars

Browse by kind, by grade A, or by owner.