skill-smell-checker SKILL.md skillA
skill-smell-checker from lu1sdv/skillsmd is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add lu1sdv/skillsmd/skill-smell-checker@git:20260718.97ecb4ePins git:20260718.97ecb4e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- lu1sdv/skillsmd
- Path
skill-smell-checker/SKILL.md- Versions recorded
- 1
- Latest version
- git:20260718.97ecb4e, committed Jul 18, 2026
- Size
- 4,517 bytes
- Repository stars
- 2
- License
- none declared
Audits Agent Skill SKILL.md files for the 26 skill smells defined in arXiv:2607.01456, separating five static checks from 21 semantic checks. It applies when reviewing, linting, authoring, or refactoring SKILL.md files; when a skill quality audit is requested; or when terms such as skill smell, SSD, static skill check, context bloat, missing guardrails, or vague skill description appear.
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 Smell Checker Audit all 26 smells from Hong, Imani, and Ahmed's *From Anatomy to Smells*. Treat the five static results as script-derived facts and the other 21 as evidence-backed semantic judgments. ## Workflow 1. Locate the target `SKILL.md`. For a repository-wide audit, discover files with `rg --files -g '**/SKILL.md'`. 2. Run the deterministic harness: ```bash python SKILL_DIR/scripts/check_static_smells.py path/to/SKILL.md --pretty ``` Replace `SKILL_DIR` with this skill's directory. Do not manually override its five results. Use `--strict` only when a nonzero exit status should fail CI. 3. Read [references/smell-catalog.md](references/smell-catalog.md) completely. 4. Review every semantic smell against the full target skill and any bundled `scripts/`, `references/`, or `assets/` needed to judge delegation, validation, templates, or utility-script availability. 5. For each semantic smell, record `present`, `absent`, or `uncertain`, cite concrete file evidence, and give confidence. Never infer a clean result from a missing section title alone. 6. Produce the report using the template below. Rank fixes by security, …
Read the whole file at its exact version.
How to install
mdr add lu1sdv/skillsmd/skill-smell-checker@sha256:83b6fb7141e834cbThe line at the top of this page pins the label git:20260718.97ecb4e, 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.
[](https://markdownregistry.com/a/art_kmkcgiquj7zq3mve)
4 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Jul 18, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4517 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
lu1sdv/skillsmd · 2 stars · license none declared · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kmkcgiquj7zq3mve GET https://markdownregistry.com/api/v1/resolve?ref=lu1sdv/skillsmd/skill-smell-checker GET https://markdownregistry.com/api/v1/blob/83b6fb7141e834cb5314740a267a78423d2f6690212b2fb1554d240f843286da
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.