Skill Authoring

Author, review, and validate Agent Skills (SKILL.md folders) against the agentskills.io spec and Google's Agent Skills whitepaper: frontmatter constraints, naming, description-as-router, progressive disclosure, bundled scripts/references/assets, and evaluation gates. Use when creating a new skill, editing or reviewing an existing SKILL.md, converting a runbook or successful agent trace into a skill, or deciding whether content belongs in a skill vs AGENTS.md vs an MCP server.

10 stars 2 forksSkill & Plugin Authoring

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Archive228/lab-skills --skill skill-authoring
Manual install
git clone --depth 1 https://github.com/Archive228/lab-skills.git /tmp/lab-skills
mkdir -p ~/.claude/skills
cp -r /tmp/lab-skills/skills/skill-authoring ~/.claude/skills/skill-authoring

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Authoring Agent Skills

This skill is the operating procedure for writing skills that comply with the Agent Skills specification (agentskills.io) and follow Google's Agent Skills whitepaper guidance on portable skill design. It covers the SKILL.md format, frontmatter constraints, naming, the description field as a routing mechanism, progressive disclosure, bundled resources, and the evaluation gates a skill must pass. The whitepaper's core discipline: a skill without a test is a hope, not a capability.

## When to use

- Creating a new skill folder from scratch, from a runbook/doc, or from a successful agent trace.
- Reviewing, refactoring, or debugging an existing SKILL.md (wrong triggering, bloated body, vague description).
- Deciding where content belongs: skill vs AGENTS.md vs MCP.

Do NOT use this skill for:
- One-off task instructions — just do the task; a skill is for reusable workflows.
- Project-wide conventions (stack, build commands) — those belong in AGENTS.md, which is always loaded; skills load on demand. Vercel's production analysis found a passive AGENTS.md index of project conventions hit a 100% pass rate vs a 53% baseline — global context belongs there, skills are for narrow, action-specific workflows.
- Connecting the agent to an external system (Drive, Salesforce, an API) — that is an MCP server's job. Skills and MCP compose: the skill is know-how, MCP is reach. Do not reinvent MCP as scripts.

## Rules

### Structure (spec-normative)
Read the full skill on GitHub

Details

Skill name
skill-authoring
Path
skills/skill-authoring/SKILL.md
License
MIT
Repo updated
12 August 2026

FAQ

What does the Skill Authoring skill do?

Author, review, and validate Agent Skills (SKILL.md folders) against the agentskills.io spec and Google's Agent Skills whitepaper: frontmatter constraints, naming, description-as-router, progressive disclosure, bundled scripts/references/assets, and evaluation gates. Use when creating a new skill, editing or reviewing an existing SKILL.md, converting a runbook or successful agent trace into a skill, or deciding whether content belongs in a skill vs AGENTS.md vs an MCP server.

How do I install the Skill Authoring skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Archive228/lab-skills --skill skill-authoring. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Skill Authoring popular?

It lives in Archive228/lab-skills, which has 10 GitHub stars and 2 forks.

Related skills

Agent Design Fundamentals

10

Archive228/lab-skills

Decision rules for whether to build an LLM agent and how to architect it, distilled from OpenAI's "A Practical Guide to Building Agents": build/no-build criteria, model selection, tool design, single-agent vs multi-agent orchestration (manager pattern vs decentralized handoffs), layered guardrails, and human-in-the-loop triggers. Use when designing, reviewing, or refactoring an agent system — before choosing an architecture, adding more agents, defining tools, or shipping an agent to production without guardrails.

AI, LLMs & Agents

Agent Evals

10

Archive228/lab-skills

Build and maintain evaluation suites for AI agents: bootstrap 20-50 tasks from real failures, pick code-based vs model-based vs human graders by agent architecture (coding, conversational, research, computer-use), write unambiguous tasks with reference solutions, and keep suites alive via ownership and transcript reading. Use when creating evals from zero, adding graders or eval cases, debugging suspicious eval scores, or deciding pass@k vs pass^k metrics for an agent product.

AI, LLMs & Agents

Agent Failure Preflight

10

Archive228/lab-skills

Pre-deployment failure-mode gate for agentic AI systems, distilled from Microsoft AI Red Team's Taxonomy of Failure Modes in Agentic AI Systems v2.0 (grounded in 12 months of red-team engagements). Run it before shipping or materially changing an agent — adding tools/MCP servers/plugins, enabling persistent memory, adding sub-agents or orchestration, enabling computer use, or expanding permissions — to verify concrete controls against memory poisoning, HitL bypass, goal hijacking, supply-chain compromise, session context contamination, capability disclosure, and multi-agent cascade failures.

AI, LLMs & Agents

Skill Finder

9

kargnas/skills

Finds and ranks installable SKILL.md agent-skill packages for a task: discovers via the `npx skills` marketplace plus a GitHub-wide sweep, then ranks by real human iteration — semantic polish-days, content depth (production vs toy signals), and optional social review — not stars or install counts. Use for skill discovery: find/search a skill, 'is there a skill for X', task-specific skill lookup, compare skills. Delegates the GitHub search itself to the oss-finder skill; finding general OSS libraries/frameworks/tools (not SKILL.md packages) also goes to oss-finder.

Skill & Plugin Authoring

Planning Before Create Skill

5

thePlannerIvan/planning-before-create-skill

创建或升级 Skill 时使用的设计与验收准则。明确目标和好坏判据,按需沉淀工具与专业经验;升级时依据真实问题修正、验证并清理失效内容。

Skill & Plugin Authoring

Skill Creator

9

ydnikolaev/antigravity-factory

Defines the philosophy and process for creating high-quality Antigravity skills. Use this skill when asked to create a new skill or standardize an existing one.

Skill & Plugin Authoring

Browse the most popular Claude skills, all skill & plugin authoring skills, or write your own with the skills generator.