How do I install the Skill Authoring skill?

Run npx skillmds add majiayu000/skill-authoring-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Skill Authoring safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Skill Authoring?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Skill Authoring free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Skill Authoring?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Skill Authoring by majiayu000 — Agent Skill

Name: Skill Authoring
Rating: 4.2 (5 reviews)
Author: majiayu000

Skill Authoring

Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do. Use this when creating a new skill, editing an existing one, diagnosing a skill that fires too often or never fires, or reviewing a set of skills for overlap. Also use before adding to a skill library, to check the capability is not already covered.

majiayu000 3b18e80 2 files · 4.0 KB Updated Sep 9, 2026 567 repo stars

File contents

Skill authoring

A skill is judged twice: on whether it loads at the right moment, and on whether it helps once loaded. Most fail the first test.

The description does the triggering

It is the only part read when deciding whether to load. Write it for that job:

Lead with what the skill does, in one clause.
Then when to reach for it — the situations, in the words someone would actually use, including the oblique ones ("why isn't this converting" as well as "CRO audit").
Name the edge cases that should still trigger it, and where useful, what should not.

Vague descriptions produce two failures at once: the skill misses cases it should catch, and fires on cases it cannot help.

The body does the work

Write for someone competent who has not thought about this problem today. That means:

Method over exhortation. "Be thorough" is noise. An ordered procedure is instruction.
State the failure behind each rule. A rule with no failure attached gets optimized away by the next reader.
Be specific enough to be wrong. Guidance too hedged to contradict is too vague to follow.
Put long material in references/ and say when to read it. The body should fit in working memory.

Overlap is the silent killer

Two skills whose descriptions both match a request means neither reliably wins. Before adding one, check what already covers the ground. Prefer extending an existing skill, or consolidating the family into one skill with references, over adding a near-neighbor.

Mechanics

name must be lowercase-hyphenated and equal the directory name, or the skill will not load.
One skill, one directory, SKILL.md at its root; supporting material in references/ and scripts/.

Verify before shipping

Write three requests that should trigger it and two that should not, and check the description actually discriminates. If a near-miss request would pull it in, tighten the description.

---name: skill-authoring-3description: Writes and revises agent skills so they trigger at the right moments and give usable instruction when they do. Use this when creating a new skill, editing an existing one, diagnosing a skill that fires too often or never fires, or reviewing a set of skills for overlap. Also use before adding to a skill library, to check the capability is not already covered.--- # Skill authoring A skill is judged twice: on whether it loads at the right moment, and on whether it helps once loaded. Most fail the first test. ## The description does the triggering It is the only part read when deciding whether to load. Write it for that job: - Lead with **what the skill does**, in one clause. - Then **when to reach for it** — the situations, in the words someone would actually use, including the oblique ones ("why isn't this converting" as well as "CRO audit"). - Name the **edge cases that should still trigger it**, and where useful, what should *not*. Vague descriptions produce two failures at once: the skill misses cases it should catch, and fires on cases it cannot help. ## The body does the work Write for someone competent who has not thought about this problem today. That means: - **Method over exhortation.** "Be thorough" is noise. An ordered procedure is instruction. - **State the failure behind each rule.** A rule with no failure attached gets optimized away by the next reader. - **Be specific enough to be wrong.** Guidance too hedged to contradict is too vague to follow. - **Put long material in `references/`** and say when to read it. The body should fit in working memory. ## Overlap is the silent killer Two skills whose descriptions both match a request means neither reliably wins. Before adding one, check what already covers the ground. Prefer extending an existing skill, or consolidating the family into one skill with references, over adding a near-neighbor. ## Mechanics - `name` must be lowercase-hyphenated and equal the directory name, or the skill will not load. - One skill, one directory, `SKILL.md` at its root; supporting material in `references/` and `scripts/`. ## Verify before shipping Write three requests that should trigger it and two that should not, and check the description actually discriminates. If a near-miss request would pull it in, tighten the description.

Frequently asked questions