Creates, reviews and improves Claude skills (SKILL.md folders). Use whenever the user wants to write a new skill, turn a workflow or prompt into a reusable skill, fix a skill that does not trigger or behaves inconsistently, rewrite a skill description, add scripts or references to a skill, or check a skill against best practices, even if they only say "make this reusable". Scaffolds from a template and lints the result.
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-authoring
Turn a repeatable way of working into a skill that triggers at the right time, loads lean and produces consistent output.
```
skill-authoring/
├── SKILL.md
├── scripts/
│ ├── new_skill.sh scaffold a skill and link it in the category README
│ └── lint_skill.py check frontmatter, description, links, support files, template markers
├── references/
│ └── principles.md loading levels, description craft, body and script rules, evaluation
└── templates/
└── SKILL.template.md skeleton with the standard sections
```
## When to use
- Creating a skill from scratch or from a conversation that worked well
- A skill never triggers, or triggers when it should not
- A skill gives different results each run
- A SKILL.md has grown too long or messy
- Reviewing a skill before publishing it
## Workflow
1. **Capture intent**: what should the skill do, which phrases should trigger it, what is the expected output, what is out of scope. If the conversation already contains a good workflow, extract it: tools used, order of steps, corrections the user made.
…
The line at the top of this page pins the label git:20261101.e2eb6f8, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_4gq2q5jyaq37cmaq
GET https://markdownregistry.com/api/v1/resolve?ref=mehranqadirian/skills/skill-authoring
GET https://markdownregistry.com/api/v1/blob/2b0f7365581c544bffbdc4437ef5080878f819f32255a39a08678bb9a5085461
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.
mehranqadirian/skills · agent-engineering/multi-agent-orchestration/SKILL.md · Designs and runs systems where several AI agents cooperate. Use whenever the user wants to split a task across agents…
mehranqadirian/skills · agent-engineering/prompt-regression-testing/SKILL.md · Builds and runs regression tests for prompts, skills and agents so changes can be checked instead of guessed. Use…
mehranqadirian/skills · data/csv-profiling/SKILL.md · Profiles and safely cleans CSV files. Use whenever the user shares or mentions a CSV, TSV or spreadsheet export, asks…
mehranqadirian/skills · devops/docker-basics/SKILL.md · Reviews, writes and troubleshoots Dockerfiles and container builds. Use whenever the user shares a Dockerfile or…
mehranqadirian/skills · devops/github-actions/SKILL.md · Writes, reviews and debugs GitHub Actions workflows. Use whenever the user edits a file under .github/workflows, asks…
mehranqadirian/skills · devops/linux-troubleshooting/SKILL.md · Diagnoses problems on Linux machines in a structured, read-only-first way. Use whenever the user reports a slow or…
mehranqadirian/skills · devops/shell-scripting/SKILL.md · Writes, reviews and fixes shell scripts (bash and sh) so they are safe, portable and testable. Use whenever the user…
mehranqadirian/skills · documents/document-conversion/SKILL.md · Converts documents between Markdown, Word, HTML, PDF, EPUB and plain text with pandoc, including right-to-left Persian…
mehranqadirian/skills · documents/pdf-atelier/SKILL.md · House style for creating ANY new PDF with Claude - reports, proposals, brochures, menus, resumes, certificates…
mehranqadirian/skills · documents/pdf-processing/SKILL.md · Processes, extracts and verifies existing PDF files. Use whenever the user wants to read text or tables from a PDF, OCR…
mehranqadirian/skills · git/git-recovery/SKILL.md · Recovers lost git work and undoes mistakes safely. Use whenever the user says they lost commits, ran git reset --hard…
nyldn/claude-octopus · .claude/skills/skill-authoring/SKILL.md · Principles for writing skills that behave the same way every run — use when adding, editing, or reviewing a skill in…
nyldn/claude-octopus · skills/skill-authoring/SKILL.md · Principles for writing skills that behave the same way every run — use when adding, editing, or reviewing a skill in…
cbrock84/headcount · plugins/technology/skills/skill-authoring/SKILL.md · Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do. Use this…
athola/claude-night-market · plugins/abstract/skills/skill-authoring/SKILL.md · Guide creating Claude Code skills with TDD and persuasion principles. Use for new skill development.
