skill-authoring is agent-read markdown (skill) from majdghithan/agent-skills: Author, structure, verify, and publish a high-quality agent skill (SKILL.md). Use whenever the user wants to "write a skill", "create a skill for X", turn expertise or a workflow into a reusable skill, improve an existing SKILL.md, or publish a skill to their repo. Covers the SKILL.md format, writing a strong description, progressive disclosure with reference files, the detect-context-first pattern, fact-verification discipline, testing, and the publish workflow..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Skill authoring - write a great, publishable skill
A skill is a `SKILL.md` file (YAML frontmatter + markdown instructions) that an agent loads when its work matches. Optionally it bundles supporting files (`references/*.md`, `scripts/`) loaded on demand. Good skills are **specific, accurate, and lean**. This skill is how to write one.
## 1. Decide it should exist
Write a skill when there's real, reusable know-how an agent would otherwise get wrong or generic: a framework's version-specific rules, a migration's gotchas, a self-hosting workflow, a house style. **Don't** write one for a one-off task, or for something the model already does well. Check the ecosystem first (`npx skills find <topic>`) - if a great one exists, install it instead; if only generic ones exist, that's your gap.
## 2. Frontmatter - name + description (the description is critical)
```yaml
---
name: kebab-case-name # matches the folder name
description: <what it does> + <when to use it> + <trigger phrases> + <when NOT to use>
---
```
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_j5olyvhjoofc62pu
GET https://markdownregistry.com/api/v1/resolve?ref=majdghithan/agent-skills/skill-authoring
GET https://markdownregistry.com/api/v1/blob/9ce08e82a245037025c7b21501381e5a3b72115f483584bda4ba22b2d3152408
Your agent 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.
majdghithan/agent-skills · skills/filament-plugin-development/SKILL.md · Build and publish custom Filament plugins (Filament is the Laravel admin-panel framework). Use when creating a Filament…
majdghithan/agent-skills · skills/lahja/SKILL.md · Arabic dialects (لهجة) writing skill - write or rewrite Arabic in a specific spoken dialect with correct dialect…
majdghithan/agent-skills · skills/laravel-architecture-review/SKILL.md · Review a Laravel codebase's architecture and design, not just its types. Use when asked to audit a Laravel app, find…
majdghithan/agent-skills · skills/laravel-filament/SKILL.md · Version-aware best practices for Filament (the Laravel admin-panel / TALL-stack framework by filamentphp), covering v1…
majdghithan/agent-skills · skills/laravel-mixpost/SKILL.md · Self-host and operate Mixpost (the open/self-hosted social-media scheduler by Inovector) inside a Laravel app -…
majdghithan/agent-skills · skills/laravel-mysql-to-postgres/SKILL.md · Migrate a Laravel application's database from MySQL/MariaDB to PostgreSQL safely. Use when moving a Laravel app to…
majdghithan/agent-skills · skills/laravel-upgrade/SKILL.md · Upgrade a Laravel application across major versions safely (Laravel 8 -> 9 -> 10 -> 11 -> 12 -> 13), one hop at a time…
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…
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.
microsoft/github-copilot-for-azure · .github/skills/skill-authoring/SKILL.md · Guidelines for writing Agent Skills that comply with the agentskills.io specification. WHEN: "create a skill", "new…
