claude-skill-spec-audit SKILL.md skillA

claude-skill-spec-audit from jackchuka/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jackchuka/skills/claude-skill-spec-audit@git:20260604.c9bb57f

Pins git:20260604.c9bb57f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jackchuka/skills
Path
claude-skill-spec-audit/SKILL.md
Versions recorded
3
Latest version
git:20260604.c9bb57f, committed Jun 4, 2026
First version recorded
Mar 11, 2026
Size
10,875 bytes
Repository stars
15
License
MIT

Audit skill SKILL.md files for compliance with the agentskills.io specification and house conventions. Checks frontmatter fields (name, description, compatibility, metadata, argument-hint), metadata sub-fields (author, scope, layer, confirms), and layer/suffix consistency. Use when adding new skills, reviewing skill quality, or ensuring all skills follow the spec. Triggers: "audit skills", "check skill spec", "skill compliance", "are my skills up to spec", "/claude-skill-spec-audit".

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 Spec Audit

Check installed skills against the [agentskills.io specification](https://agentskills.io/specification) and local conventions for metadata completeness.

## Arguments

- **Skill names**: tokens after the command -> filter to those skills only
- **--fix**: automatically add missing fields (prompts for values)
- **Default**: scan all non-symlinked skills in `~/.claude/skills/`

## Spec Requirements (agentskills.io)

| Field           | Required | Notes                                                          |
| --------------- | -------- | -------------------------------------------------------------- |
| `name`          | Yes      | 1-64 chars, lowercase, hyphens only, must match directory name |
| `description`   | Yes      | 1-1024 chars, non-empty                                        |
| `compatibility` | No       | Max 500 chars, environment requirements                        |
| `metadata`      | No       | Arbitrary key-value map                                        |
| `allowed-tools` | No       | Space-delimited tool list (experimental)                       |

## Naming Conventions
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jackchuka/skills/claude-skill-spec-audit@sha256:05fde3736a334a32

The line at the top of this page pins the label git:20260604.c9bb57f, 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_aieik5zijupahqw4.svg)](https://markdownregistry.com/a/art_aieik5zijupahqw4)

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

Versions

The registry has recorded 3 versions of this file, between Mar 11, 2026 and Jun 4, 2026, about one every 42 days.

versioncommittedcommitsizeaudit
git:20260604.c9bb57f latest2026-06-04 c9bb57f 10,875 BA view · diff
git:20260421.19f33a52026-04-21 19f33a5 9,493 BA view · diff
git:20260311.28354062026-03-11 2835406 9,480 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 (10875 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

jackchuka/skills · 15 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_aieik5zijupahqw4
GET https://markdownregistry.com/api/v1/resolve?ref=jackchuka/skills/claude-skill-spec-audit
GET https://markdownregistry.com/api/v1/blob/05fde3736a334a32dbe057e03e0f59e52709de89d8feb2bc671b8c4b6736dcdd

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 jackchuka/skills

claude-permissions-audit SKILL.md skill
jackchuka/skills · claude-permissions-audit/SKILL.md · Review and reorganize Claude Code permission settings across all config files (global settings.json, project…
git:20260604.0da3398 · audit A · 15 stars
claude-skill-orchestration-audit SKILL.md skill
jackchuka/skills · claude-skill-orchestration-audit/SKILL.md · Audit skills for agentic orchestration quality. Checks subagent dispatch patterns, parallelism opportunities…
git:20260604.0da3398 · audit A · 15 stars
claude-skill-prereq-audit SKILL.md skill
jackchuka/skills · claude-skill-prereq-audit/SKILL.md · Scan skills for prerequisite tools, MCP servers, and auth requirements, then check if everything is installed and…
git:20260604.0da3398 · audit A · 15 stars
dev-cli-consistency-audit SKILL.md skill
jackchuka/skills · dev-cli-consistency-audit/SKILL.md · Reviews a CLI tool's command interface for consistency in argument naming, flag conventions, help text, and README…
git:20260604.0da3398 · audit A · 15 stars
dev-code-quality SKILL.md skill
jackchuka/skills · dev-code-quality/SKILL.md · Systematic codebase quality scan for identifying duplication, redundancy, and improvement opportunities. Use when…
git:20260604.0da3398 · audit A · 15 stars
dev-new-tool SKILL.md skill
jackchuka/skills · dev-new-tool/SKILL.md · End-to-end workflow for taking a new tool idea from research to working MVP. Use when the user has an idea for a CLI…
git:20260604.0da3398 · audit A · 15 stars
dev-software-design SKILL.md skill
jackchuka/skills · dev-software-design/SKILL.md · Opinionated guide to software design principles and architectural patterns. Use when reviewing code design, planning…
git:20260604.0da3398 · audit A · 15 stars
gh-dep-pr-triage SKILL.md skill
jackchuka/skills · gh-dep-pr-triage/SKILL.md · Triage and fix dependency update PRs (Renovate, Dependabot, etc.). Use when the user wants to review dependency PRs…
git:20260616.917ea64 · audit A · 15 stars
gh-issue-report SKILL.md skill
jackchuka/skills · gh-issue-report/SKILL.md · Investigate and file bug reports on GitHub repositories. Searches existing issues to avoid duplicates, checks…
git:20260604.0da3398 · audit A · 15 stars
gh-org-chart SKILL.md skill
jackchuka/skills · gh-org-chart/SKILL.md · Generate an interactive HTML org explorer from a GitHub organization. Surfaces team hierarchy, members, owned repos…
git:20260604.280bb05 · audit A · 15 stars
gh-oss-go-bump SKILL.md skill
jackchuka/skills · gh-oss-go-bump/SKILL.md · Bump Go version across multiple OSS repositories. Use when the user wants to update Go across repos, says "bump go…
git:20260604.0da3398 · audit A · 15 stars
gh-oss-release-prep SKILL.md skill
jackchuka/skills · gh-oss-release-prep/SKILL.md · Systematic OSS release preparation checklist. Use when preparing a repository for open-source publishing, making a…
git:20261028.3cddcb2 · audit A · 15 stars

Every file in jackchuka/skills

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