Author a new skill for this repository end to end by choosing its category, writing trigger-friendly frontmatter, structuring the SKILL.md, splitting reference material into companion files, then regenerating the registry and README catalog. Use when creating, scaffolding, restructuring, or reviewing a skill in this repo.
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
Create a new skill that fits this repository's conventions and earns its place: one clear job, a description that triggers reliably, a lean `SKILL.md`, and any heavy detail pushed into companion files. Then regenerate the derived files and validate.
This repo's source layout is `skills/<category>/<name>/SKILL.md`. The **category is the folder**, so there is no category field. Everything else (per-skill `registry.json`, the root `registry.json`, the README catalog) is *generated* by `pnpm gen` from the folder location plus the frontmatter. Never hand-edit generated files.
## Hard rules: never break these
- **One skill, one job.** If it needs "and" to describe it, it's probably two skills. Split rather than bloat.
- **Earn the skill.** Don't create one for a single command or something a plain instruction covers. A skill is worth it when there's a reusable, multi-step procedure with judgment and rules.
- **Never hand-write `registry.json`** (per-skill or root) or the README catalog. They are derived; run `pnpm gen`. Editing them by hand guarantees drift.
…
The line at the top of this page pins the label git:20261005.5100bf0, 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_si7efkvcvafzk5rc
GET https://markdownregistry.com/api/v1/resolve?ref=khaledsaeed18/dotclaude/create-skill
GET https://markdownregistry.com/api/v1/blob/dc8b820fdb4cf4bbee329daa19dcb8a8c7cf252d9db55d1bd4da0488a4aa2c9c
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.
khaledsaeed18/dotclaude · .agents/skills/improve/SKILL.md · Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/coolify-image-app/SKILL.md · Create and configure a Coolify application that runs a prebuilt image from a registry. Use when adding an app to…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/coolify-vps-baseline/SKILL.md · Prepare a Linux VPS to run production containers under Coolify. Use when setting up a new server, auditing an existing…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/deploy-verification/SKILL.md · Prove a deployment from the server side. Use when a deploy finished and needs sign-off, when a rolling update may have…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/express-prisma-coolify-image/SKILL.md · Package an Express and Prisma API as a runtime-only image that migrates its Postgres database at start. Use when…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/ghcr-coolify-pipeline/SKILL.md · Write the single GitHub Actions workflow that takes a repository from pull request to production through GHCR and…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/live-domain-cutover/SKILL.md · Move a live domain from one host to another without downtime or lost sessions, with a rehearsal, a timed DNS switch, a…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/nextjs-coolify-image/SKILL.md · Package a Next.js app as a runtime-only container image with a health probe and a fast shutdown. Use when…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/proxy-client-address/SKILL.md · Forward the real client address from a server-side proxy to a backend without trusting forgeable headers. Use when an…
khaledsaeed18/dotclaude · .claude-plugin/plugins/deploy/skills/vps-ops-toolkit/SKILL.md · Install host operations on a VPS, with a cron health check that alerts on change, restore-verified encrypted database…
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/adr-writing/SKILL.md · Write Architecture Decision Records that a future engineer can act on: a numbered, immutable record with the context…
khaledsaeed18/dotclaude · .claude-plugin/plugins/docs/skills/openapi-spec/SKILL.md · Write, generate, or review an OpenAPI 3.1 specification for an HTTP API so that it is accurate to the implementation…
cherryhq/cherry-studio · .agents/skills/create-skill/SKILL.md · Create a new skill in the current repository. Use when the user wants to create/add a new skill, or mentions creating a…
tailcallhq/forgecode · crates/forge_repo/src/skills/create-skill/SKILL.md · Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an…
dotnet/skills · .agents/skills/create-skill/SKILL.md · Scaffolds new agent skills for the dotnet/skills repository. Use when creating a new skill, generating SKILL.md files…
sethgammon/citadel · skills/create-skill/SKILL.md · Creates new skills from the user's repeating patterns. Interview-driven: discovers the task, analyzes failure modes…
coco-research/coco · adapters/cursor/skills/create-skill/SKILL.md · Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a…
affitor/affiliate-skills · skills/meta/create-skill/SKILL.md · Turn a repeatable AI prompt or workflow into a structured, shareable skill for the affiliate-skills GitHub repository…
aiskillstore/marketplace · skills/0xmsc/create-skill/SKILL.md · Guide for creating new Agent Skills. Use this skill when you need to create a new skill.
tobihagemann/turbo · codex/skills/create-skill/SKILL.md · Create a new skill or update an existing skill that extends Codex's capabilities with specialized knowledge, workflows…