SkillAgentSearch skills...

skill-authoring

Creates and structures SKILL.md files for AI coding agents, including YAML frontmatter, trigger phrases, directive instructions, decision trees, code examples, and verification checklists

Install / Use

npx skills add rohitg00/skillkit --skill skill-authoring

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

88/100

Supported Platforms

Claude Code

Our assessment of skill-authoring

skill-authoring scores 88/100 on our quality scale, 591st of 1,155 Content & Media skills we index.

Its SKILL.md is 5.9 KB long, well organised into 28 sections with 6 code examples: a thorough specification that gives an agent plenty to work with.

With 1,538 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
15/15
Adoption
14/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-01 found the source still online.
  • It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 98/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

skill-authoring compared with similar skills

All 4 of these similar skills score higher than skill-authoring; compare them before choosing.

SkillScoreStarsUpdatedFormat
skill-authoring (this skill)by rohitg00881.5k6mo agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install skill-authoring?
Run npx skills add rohitg00/skillkit --skill skill-authoring. The install tabs above show the steps for each supported agent.
Which AI agents does skill-authoring work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is skill-authoring safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 98/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is skill-authoring still maintained?
The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

name: skill-authoring description: Creates and structures SKILL.md files for AI coding agents, including YAML frontmatter, trigger phrases, directive instructions, decision trees, code examples, and verification checklists. Use when the user asks to write a new skill, create a skill file, author agent capabilities, generate skill documentation, or define a skill template for Claude Code agents. version: 1.0.0 triggers:

  • write a skill
  • create skill
  • author skill
  • skill template
  • how to write skills tags:
  • meta
  • authoring
  • skills
  • writing difficulty: intermediate estimatedTime: 20 relatedSkills: []

Skill Authoring Guide

You are authoring a SKILL.md for an AI coding agent. A well-written skill provides clear, actionable guidance that agents can follow consistently.

Core Principle

A skill's description triggers it; the body teaches it.

The description tells the agent WHEN to use the skill. The content tells the agent HOW to execute it.

Skill Anatomy

SKILL.md Structure

---
name: [lowercase-hyphenated-name]
description: [Concrete actions + "Use when..." clause]
version: [Semantic version]
triggers:
  - [keyword 1]
  - [keyword 2]
tags:
  - [tag 1]
---

# [Skill Title]

[Introduction paragraph explaining purpose]

## Core Principle

**[Single most important rule in bold]**

## [Main Content Sections]

## [Decision Points]

## [Verification Checklist]

Frontmatter Fields

| Field | Required | Constraints | |-------|----------|-------------| | name | Yes | Lowercase alphanumeric + hyphens, 1–64 chars | | description | Yes | Must include "Use when..." clause; 1–1024 chars | | version | Yes | Semantic version (e.g. 1.0.0) | | triggers | Recommended | Natural-language phrases that activate the skill | | tags | Recommended | Categorization tags |

Writing Effective Triggers

Triggers should be phrases users naturally type.

Good triggers:

  • "write tests first"
  • "tdd"
  • "test driven development"

Bad triggers:

  • "testing methodology" (too vague)
  • "red-green-refactor-cycle-for-test-driven-development" (too specific)
  • "skill-123" (not natural language)

Trigger Guidelines

  1. Natural language — How would a human ask for this?
  2. Multiple variations — Different ways to say the same thing
  3. Specific enough — Don't trigger on too many queries
  4. Common terms — Use terms people actually use

Writing Skill Content

Voice and Tone

Use second person, present tense, active voice:

  • ✅ "Write the test first"
  • ✅ "You are implementing TDD"
  • ❌ "The developer should..." (passive)
  • ❌ "It is recommended that..." (wordy)

Structure Guidelines

  1. Start with context — What is the agent doing and why
  2. State the core principle — Most important rule upfront
  3. Provide process — Step-by-step guidance
  4. Include examples — Concrete illustrations
  5. Add a checklist — Verification criteria
  6. End with integration — How this connects to other skills

Directive Language

| Strength | Examples | |----------|----------| | Strong (critical rules) | "You MUST…", "ALWAYS…", "NEVER…", "Do NOT…" | | Soft (recommendations) | "Prefer…", "Consider…", "When possible…" |

Content Patterns

Decision Trees

## Decision: [What to Decide]

If [condition A]:
→ [Action for A]

If [condition B]:
→ [Action for B]

If uncertain:
→ [Default action]

Process Steps

### Step 1: [Action]

[Detailed explanation]

**Verification:** [How to know step is complete]

### Step 2: [Action]
...

Code Examples

// BAD
const result = doTheThing(badInput);

// GOOD
const validated = validate(input);
const result = doTheThing(validated);

Anti-Patterns to Avoid

| Anti-pattern | Problem | Fix | |--------------|---------|-----| | The Encyclopedia | Too much info, agent gets lost | Focus on actionable guidance only | | The Vague Guide | "Consider best practices" | Be specific: "Use Arrange-Act-Assert" | | The Constraint-Free Skill | No clear rules, agent improvises | Include explicit constraints | | The Monologue | Wall of text | Use headers, lists, tables, code blocks | | The Outdated Skill | References deprecated patterns | Version skills and review periodically |

Skill Testing

Before publishing, verify:

  1. Trigger test — Does it activate on expected phrases?
  2. Completeness test — Can the agent follow it without external info?
  3. Clarity test — Is every instruction unambiguous?
  4. Contradiction test — No conflicting guidance?
  5. Edge case test — Handles unusual situations?

Pack Organization

Group related skills under a named pack directory. See PACKS.md for full pack manifest format and filesystem conventions.

packs/
├── testing/
│   ├── pack.json
│   ├── red-green-refactor/
│   │   └── SKILL.md
│   └── test-patterns/
│       └── SKILL.md

Skill Maintenance

See MAINTENANCE.md for detailed versioning policy. Quick reference:

Version increments:

  • Patch (1.0.x): Typos, clarifications, minor fixes
  • Minor (1.x.0): New sections, examples, capabilities
  • Major (x.0.0): Breaking changes, fundamental rewrites

Deprecation frontmatter:

deprecated: true
deprecatedReason: "Superseded by skill-v2"
deprecatedSince: "2024-01-15"

Add a visible notice at the top of the body: > **DEPRECATED:** Use [skill-v2] instead.

Publication Checklist

Before publishing, confirm:

  • [ ] Frontmatter is complete and valid (name, description, version)
  • [ ] Description includes concrete actions and a "Use when…" clause
  • [ ] Triggers are natural-language phrases, specific but not over-fitted
  • [ ] Core principle is clear and prominent
  • [ ] Content uses headers, lists, or tables — no walls of text
  • [ ] Code examples demonstrate correct vs. incorrect usage
  • [ ] Verification criteria are included
  • [ ] Related skills are linked where applicable
  • [ ] No spelling/grammar errors
  • [ ] Tested with target agents against all trigger phrases

Related Skills

View on GitHub
GitHub Stars1.5k
CategoryContent
Updated5mo ago
Forks150

Languages

TypeScript

Trust signals

98/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info