create-skill

Guides creation of Agent Skills with SKILL.md structure, metadata, and prior-art research.

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/HACK-WU/skills --skill create-skill-hack-wu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/HACK-WU/skills/tree/main/skills/create-skill
Command: npx skills add https://github.com/HACK-WU/skills --skill create-skill-hack-wu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating a new Agent Skill from scratch often leads to vague descriptions, bloated SKILL.md files, duplicated capabilities, and inconsistent structure. This Skill provides a complete workflow for designing, writing, and validating effective Agent Skills that agents can reliably discover and apply. ## Core Features & Use Cases - Structured Creation Workflow: Walks through discovery, prior-art research, design, implementation, and validation phases for building a new skill. - Authoring Standards: Enforces SKILL.md frontmatter rules (name, description), third-person trigger-rich descriptions, a 500-line limit, progressive disclosure, and an AI overview layer covering purpose, capabilities, and use scenarios. - Prior-Art Research: Checks sibling skills, the managed skill source, and community examples before drafting, borrowing structure and anti-patterns without copying content. - Use Case: When you want to turn a repeated team workflow (e.g., database migration review) into a reusable skill, this Skill helps you gather requirements, survey existing skills, draft the SKILL.md, and validate it against a quality checklist. ## Quick Start Ask the agent to create a new skill for your workflow, for example: create a skill that reviews database migration scripts for lock risks and rollback safety.

Frequently Asked Questions about create-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Agent Skill with SKILL.md?

Create a directory containing a SKILL.md file with YAML frontmatter defining name and description, followed by Markdown instructions. Follow a workflow of discovery, prior-art research, design, implementation, and validation to ensure quality.

What should the description field in SKILL.md contain?

The description should be written in third person, stay under 1024 characters, and include both what the skill does and when to use it. Include concrete trigger terms so the agent can match user requests to the skill.

How long should a SKILL.md file be?

Keep the main SKILL.md under 500 lines for best performance. Move detailed references, examples, and templates into separate files like reference.md that the agent reads only when needed, using progressive disclosure.

When should I not create a new skill?

Avoid creating a skill when an existing one already covers the capability, when the content is thin enough for a memory or rule, or when prior-art research shows heavy overlap. Route the decision through a discovery gate before building.

What are common mistakes when writing Agent Skills?

Common anti-patterns include vague names like helper or utils, Windows-style paths, time-sensitive information, inconsistent terminology, too many tool options, and relative paths referencing other skills instead of use_skill declarations.