improve-skill SKILL.md skillA

improve-skill from mgiovani/cc-arsenal is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mgiovani/cc-arsenal/improve-skill@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mgiovani/cc-arsenal
Path
skills/improve-skill/SKILL.md
Versions recorded
5
Latest version
v1.0.0, committed Oct 5, 2026
First version recorded
Jul 19, 2026
Size
11,638 bytes
Repository stars
8
License
MIT

Improve one or more EXISTING agent skills to the current authoring standard, with measured before/after evidence instead of a trust-me rewrite. Snapshots the current version to an immutable baseline, rewrites description/body/references against the rubric, authors or upgrades evals/evals.json and trigger-eval.json in the same pass, then benchmarks the rewrite against the frozen baseline with deterministic grading before calling it done. Use when the user wants to improve, audit, refresh…

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

# Improve Skill

Take a skill that already exists and bring it up to the current authoring standard: with a frozen baseline and a measured comparison, not just a confident rewrite. Every claim of "better" in your final report must trace to a validator run or a grading result you actually produced this session.

## Ground rules

The snapshot is write-once. Once `skill-snapshot/` exists for a skill, it is read-only for the rest of the run: every later step (rewrite, iteration, feedback pass) reads it for comparison and never writes to it. If a later step wants to "fix" the baseline to make a comparison look better, that is overfitting to the eval, not improving the skill, so refuse and explain why.

Eval prompts and assertions are frozen the same way, so never edit one just to make a failing run pass. If a rewritten skill fails an assertion, fix the skill (SKILL.md, references, description). If the assertion itself was wrong when it was written, say so explicitly and get the user's sign-off before changing it: silently loosening an assertion after seeing it fail is the one move that makes every later benchmark meaningless.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mgiovani/cc-arsenal/improve-skill@sha256:7aa0e3f0bc2506ef

The line at the top of this page pins the label v1.0.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_wozoxzr67jpdrnji.svg)](https://markdownregistry.com/a/art_wozoxzr67jpdrnji)

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

Versions

The registry has recorded 5 versions of this file, between Jul 19, 2026 and Oct 5, 2026, about one every 19 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-10-05 b620662 11,638 BA view · diff
v1.0.02026-09-25 ca015cc 10,448 BA view · diff
v1.0.02026-09-16 0d6e629 10,252 BA view · diff
v1.0.02026-07-27 fa2e9cf 10,151 BA view · diff
v1.0.02026-07-19 4ee8666 10,241 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 (11638 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

mgiovani/cc-arsenal · 8 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wozoxzr67jpdrnji
GET https://markdownregistry.com/api/v1/resolve?ref=mgiovani/cc-arsenal/improve-skill
GET https://markdownregistry.com/api/v1/blob/7aa0e3f0bc2506ef6ef206bef91dd53f4ccc2f032a1f16b3ac1b66698e7a6848

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 mgiovani/cc-arsenal

AGENTS.md AGENTS.md file
mgiovani/cc-arsenal · AGENTS.md
git:20261005.b0bf138 · audit A · 8 stars
CLAUDE.md CLAUDE.md file
mgiovani/cc-arsenal · CLAUDE.md
git:20260924.a80f9cd · audit B · 8 stars
CLAUDE.md@examples/claude-md/bash CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/bash/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/fastapi CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/fastapi/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/nodejs CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/nodejs/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
CLAUDE.md@examples/claude-md/reactjs CLAUDE.md file
mgiovani/cc-arsenal · examples/claude-md/reactjs/CLAUDE.md
git:20260925.ca015cc · audit A · 8 stars
llms.txt@scripts/tests/fixtures/anything_to_skill/web llms.txt file
mgiovani/cc-arsenal · scripts/tests/fixtures/anything_to_skill/web/llms.txt
git:20260930.e89382d · audit A · 8 stars
agent-browser SKILL.md skill
mgiovani/cc-arsenal · skills/agent-browser/SKILL.md · Headless browser automation CLI optimized for AI agents: drives a real browser via accessibility-tree snapshots and…
git:20261005.b620662 · audit A · 8 stars
anything-to-skill SKILL.md skill
mgiovani/cc-arsenal · skills/anything-to-skill/SKILL.md · Turns a docs site, local folder, PDF or book, YouTube video, playlist or channel, or a topic into a source-grounded…
git:20261005.b620662 · audit A · 8 stars
ci-generate SKILL.md skill
mgiovani/cc-arsenal · skills/ci-generate/SKILL.md · Generate a production-ready CI/CD pipeline config (GitHub Actions,
v1.0.0 · audit A · 8 stars
ci-local SKILL.md skill
mgiovani/cc-arsenal · skills/ci-local/SKILL.md · Run the checks a GitHub Actions workflow would run, locally, when Actions
git:20261005.b620662 · audit A · 8 stars
clotho-research SKILL.md skill
mgiovani/cc-arsenal · skills/clotho-research/SKILL.md · Find what a change will actually touch before planning it — the existing
v1.0.0 · audit A · 8 stars

Every file in mgiovani/cc-arsenal

Other files named improve-skill

improve-skill SKILL.md skill
av/skills · improve-skill/SKILL.md · Improve an existing agent SKILL.md through one gated cycle: select the target (default this skill), snapshot the…
git:20260813.b71baeb · audit A · 24 stars
improve-skill SKILL.md skill
namedtoaster/the-last-mile · skills/improve-skill/SKILL.md · Fix a Last Mile skill that did the wrong thing, from inside the project where it went wrong. Decides whether the lesson…
git:20261012.0a65810 · audit A · 14 stars
improve-skill SKILL.md skill
tomzx/agents · skills/improve-skill/SKILL.md · Inspect a single skill in the library, reason about high-value low-risk improvements, and apply them directly. Used by…
git:20261007.b35fc4b · audit A · 12 stars
improve-skill SKILL.md skill
devskale/skale-skills · deprecated/improve-skill/SKILL.md · Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a…
git:20261006.3723cb2 · audit A · 3 stars

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