skill-authoring

skill-authoring is a skill for Claude Code from komluk/scaffolding. It costs 76 tokens per session (2,075 once invoked), scanned A, original, MIT.

A guide for creating reusable skills for coding agents. A skill is a procedure saved in a standard SKILL.md file that an agent can apply to recurring work.

In plain words
What is it for?
Use it when creating, editing, reviewing, or deciding whether a repeatable procedure should become a skill.
Why use it?
It helps make those procedures consistent, discoverable, and correctly structured.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; mentions subagents; mentions Claude Code.

Part of the scaffolding plugin — 39 skills, 9 commands, 13 agents shipped together

Good fit Use it when creating, editing, reviewing, or deciding whether a repeatable procedure should become a skill.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/komluk/scaffolding/skill-authoring
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add komluk/scaffolding --skill skill-authoring
Clone the repo
git clone --depth 1 https://github.com/komluk/scaffolding

Made for: Claude Code.

Or install scaffolding, the plugin that ships this one along with the rest of its 39 skills, 9 commands, 13 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for skill-authoring

README.md
[![agentmods](https://agentmods.dev/badge/skills/komluk/scaffolding/skill-authoring/github.svg)](https://agentmods.dev/skills/komluk/scaffolding/skill-authoring)
Your own site
<a href="https://agentmods.dev/skills/komluk/scaffolding/skill-authoring"><img src="https://agentmods.dev/badge/skills/komluk/scaffolding/skill-authoring/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for skill-authoring

Your own site · 80×15
<a href="https://agentmods.dev/skills/komluk/scaffolding/skill-authoring"><img src="https://agentmods.dev/badge/skills/komluk/scaffolding/skill-authoring.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 76 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,075 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00076 $0.02075
Opus 5.5 $0.00030 $0.00830
Sonnet 5.5 $0.00015 $0.00415
Haiku 4.5 $0.00008 $0.00208

Measured 2mo ago against content hash 32b0af012aa0, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

skill-authoring scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/skill-authoring/SKILL.md · 182 lines

How it starts

The opening of the file, as written. The whole thing — 182 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.
description Required. Non-empty, 1–340 characters. Follows the Description Contract below.
context Optional. Only value: fork — run the skill in an isolated forked subagent. See "Context: fork".
agent Optional. Sub-agent for a forked skill: Explore, Plan, or general-purpose.
effort Optional. Reasoning-effort hint: low, medium, or high.

name and description are the only required fields. context, agent, and effort are optional delivery-tuning fields. All five are value-checked by validators/validate-skill.sh; any other frontmatter key is left untouched.


Description Contract

The description field drives Claude Code's automatic skill invocation. A vague or overbroad description either fails to trigger or triggers on the wrong tasks. Every scaffolding skill description MUST follow this template:

"<one-line capability summary>. TRIGGER when: <2-4 concrete observable situations>. SKIP: <1-2 cases handled by a named neighbour skill or out of scope>."

Read the full file on GitHub · 182 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 182 lines · 76 tokens per session scan A 32b0af012aa0

Subscribe to this mod's changes

skill-authoring is a skill published in the GitHub repository komluk/scaffolding (15 stars, last pushed today), licensed MIT. It adds 76 tokens to every session and 2,075 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

seo-strategy

Audits and improves organic search performance — technical health, site architecture, internal linking, structured data, and the content decisions that determine what can rank. Use this to run an SEO audit, diagnose why pages are not ranking or were deindexed, plan a site's URL and navigation structure, add structured…

cbrock84/headcount · 74 tokens

financial-statement-analysis

Reads a set of financial statements and establishes what changed and why — fluctuation analysis against prior period and against budget, profitability, liquidity, solvency and efficiency ratios, benchmarking, and the non-GAAP measures presented alongside them. Use this to interpret results, review a counterparty's or…

cbrock84/headcount · 93 tokens

youtube-producer

Plans, packages, and scripts long-form video for retention and channel growth — idea selection, titles and thumbnails, script structure, and diagnosing why a video or channel underperforms. Use this for video ideas, packaging, scripting, a retention teardown, or channel strategy — including when someone describes a…

cbrock84/headcount · 86 tokens

estimating-and-contingency

Produces a cost or effort estimate someone can defend — decomposing the work, choosing between analogous, parametric and bottom-up methods, documenting the basis and its assumptions, expressing confidence as a range, and sizing contingency and management reserve separately. Use this to build an estimate, challenge one…

cbrock84/headcount · 87 tokens

support-operations

Designs and runs the support function — channels, queues, routing, staffing, service levels, quality, and the metrics that show whether it is working. Use this to set up or fix support operations, choose channels, size a team, set or renegotiate service levels, reduce cost per contact, diagnose long queues or poor…

cbrock84/headcount · 77 tokens

ai-ml-governance

Governs models and AI systems in production — intended use, evaluation, monitoring, human oversight, documentation, and the decision to deploy or retire. Use this before deploying a model or AI feature, when defining evaluation criteria, when a model's behavior has drifted, when assessing AI risk or regulatory…

cbrock84/headcount · 83 tokens