skill-authoring SKILL.md skillB

skill-authoring from komluk/scaffolding is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add komluk/scaffolding/skill-authoring@git:20260627.c37d831

Pins git:20260627.c37d831 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
komluk/scaffolding
Path
skills/skill-authoring/SKILL.md
Versions recorded
3
Latest version
git:20260627.c37d831, committed Jun 27, 2026
First version recorded
May 20, 2026
Size
8,535 bytes
Repository stars
16
License
MIT

Methodology for authoring scaffolding-compatible skills: frontmatter contract, body structure, validation. TRIGGER when: running /create-skill, writing or reviewing a SKILL.md file, or deciding if a procedure deserves its own skill. SKIP: distilling a conversation into candidates (use distill); 3-tier memory writes (use agent-memory).

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 Skill

## Purpose

Methodology for authoring scaffolding-compatible skills. A skill is a single
`SKILL.md` file under `skills/<name>/` that encodes a reusable methodology Claude
Code can auto-invoke. This skill defines the frontmatter contract, the recommended
body structure, the description-writing rules, and the quality bar every authored
skill must meet before it ships.

## When to Apply

Apply this skill when:

- Running the `/create-skill` command to scaffold a new skill
- Hand-writing or editing a `skills/<name>/SKILL.md` file
- Reviewing a skill for frontmatter correctness or auto-invocation quality
- Deciding whether a repeatable procedure deserves promotion into its own skill

Do NOT apply this skill for:

- Distilling a conversation into knowledge candidates — use `distill`
- Writing into the 3-tier file memory — use `agent-memory`

---

## Frontmatter Contract

Every `SKILL.md` MUST begin with a YAML frontmatter block delimited by `---`:

| Field | Rule |
|-------|------|
| `name` | Required. Kebab-case `^[a-z][a-z0-9-]*$`. MUST equal the parent directory name. |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add komluk/scaffolding/skill-authoring@sha256:32b0af012aa02204

The line at the top of this page pins the label git:20260627.c37d831, 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_ol4nnw6x4a6i6b3v.svg)](https://markdownregistry.com/a/art_ol4nnw6x4a6i6b3v)

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

Versions

The registry has recorded 3 versions of this file, between May 20, 2026 and Jun 27, 2026, about one every 19 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20260627.c37d831 latest2026-06-27 c37d831 8,535 BB view · diff
git:20260627.a92d1322026-06-27 a92d132 5,688 BA view · diff
git:20260520.3aa374b2026-05-20 3aa374b 4,842 BA view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No instruction to read or print local credentials (matched: cat .env)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8535 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 base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

komluk/scaffolding · 16 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ol4nnw6x4a6i6b3v
GET https://markdownregistry.com/api/v1/resolve?ref=komluk/scaffolding/skill-authoring
GET https://markdownregistry.com/api/v1/blob/32b0af012aa02204b838567b1406241557288becdc9fdd324e7d5f631af3e4dd

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 komluk/scaffolding

CLAUDE.md CLAUDE.md file
komluk/scaffolding · CLAUDE.md
git:20261023.117033c · audit A · 16 stars
agent-comms SKILL.md skill
komluk/scaffolding · skills/agent-comms/SKILL.md · SendMessage recipient validation and worktreePath safety (CWE-59). TRIGGER when: validating a SendMessage `to:`…
git:20261019.32736bd · audit A · 16 stars
agent-memory SKILL.md skill
komluk/scaffolding · skills/agent-memory/SKILL.md · Repo-local file memory under .scaffolding/ (shared/agent/conversation tiers). TRIGGER when: reading or writing…
git:20261020.3712723 · audit A · 16 stars
api-design SKILL.md skill
komluk/scaffolding · skills/api-design/SKILL.md · RESTful API design standards: resource naming, HTTP methods, status codes, pagination, versioning. TRIGGER when…
git:20260520.3aa374b · audit A · 16 stars
context-engineering SKILL.md skill
komluk/scaffolding · skills/context-engineering/SKILL.md · Optimize Claude Code context-window usage for accuracy and cost. TRIGGER when: hitting context limits, structuring…
git:20260627.c37d831 · audit A · 16 stars
database-optimization SKILL.md skill
komluk/scaffolding · skills/database-optimization/SKILL.md · Schema design, index strategy, migration safety, and query analysis. TRIGGER when: designing tables or indexes, writing…
git:20260614.9d809af · audit A · 16 stars
distill SKILL.md skill
komluk/scaffolding · skills/distill/SKILL.md · Knowledge distillation: candidate extraction, confidence scoring, tier routing. Invoked by /learn and the memory-ingest…
git:20261021.384b2b2 · audit A · 16 stars
docker-templates SKILL.md skill
komluk/scaffolding · skills/docker-templates/SKILL.md · Docker multi-stage build templates, image security, and docker-compose patterns. TRIGGER when: writing a Dockerfile…
git:20260520.3aa374b · audit A · 16 stars
error-handling SKILL.md skill
komluk/scaffolding · skills/error-handling/SKILL.md · Consistent error handling across frontend and backend layers. TRIGGER when: implementing error boundaries, exception…
git:20260614.9d809af · audit A · 16 stars
frontend-design SKILL.md skill
komluk/scaffolding · skills/frontend-design/SKILL.md · Distinctive, non-generic visual identity for new landing pages and public-facing UI. TRIGGER when: designing a new…
git:20261020.0990fb3 · audit A · 16 stars
git-operations SKILL.md skill
komluk/scaffolding · skills/git-operations/SKILL.md · Git command patterns, branching strategy, and safety protocols. TRIGGER when: managing branches, resolving merge…
git:20261106.585f6d9 · audit A · 16 stars
github-actions-template SKILL.md skill
komluk/scaffolding · skills/github-actions-template/SKILL.md · GitHub Actions CI pipeline templates and workflow YAML patterns. TRIGGER when: creating or editing a CI workflow…
git:20260520.3aa374b · audit A · 16 stars

Every file in komluk/scaffolding

Other files named skill-authoring

skill-authoring SKILL.md skill
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…
git:20261108.8380d65 · audit A · 4,409 stars
skill-authoring SKILL.md skill
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…
git:20260907.4febbb1 · audit A · 4,409 stars
skill-authoring SKILL.md skill
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…
git:20260916.e72e404 · audit A · 2,543 stars
skill-authoring SKILL.md skill
uvwt/agentdock · core-skills/skill-authoring/SKILL.md · 创建、设计、修改、重构和验证 AgentDock Skill 时使用;负责 Agent Skills 兼容的 SKILL.md、可移植核心、引用、辅助脚本、测试、安全边界和本地真实验证。
git:20260925.a4848d1 · audit A · 1,295 stars
skill-authoring SKILL.md skill
mateaix/mateclaw · mateclaw-server/src/main/resources/skills/skill-authoring/SKILL.md · Author SKILL.md skills: frontmatter, validator limits, structure.
v1.0.0 · audit A · 1,185 stars
skill-authoring SKILL.md skill
tencentcloudbase/cloudbase-ai-toolkit · skills/skill-authoring/SKILL.md · Design, improve, and evaluate reusable agent skills with high-quality SKILL.md files, precise trigger descriptions…
git:20260817.2eb60da · audit A · 1,163 stars
skill-authoring Cursor rule
borghei/claude-skills · .cursor/rules/skill-authoring.mdc · Conventions for writing or editing a SKILL.md skill package.
git:20260629.ee6fb37 · audit A · 1,075 stars
skill-authoring SKILL.md skill
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.
git:20260902.b3bb3ff · audit A · 348 stars

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