create-agent-skill

Create and validate Agent Skills with SKILL.md frontmatter and directory structure.

Updated Nov 7, 2025
One-click install
npx skills add https://github.com/notwillk/rulesy --skill create-agent-skill-notwillk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-agent-skill
Source: https://github.com/notwillk/rulesy/tree/main/.agents/skills/create-agent-skill
Command: npx skills add https://github.com/notwillk/rulesy --skill create-agent-skill-notwillk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Writing Agent Skills that activate reliably and follow the specification is error-prone: invalid names, vague descriptions, oversized SKILL.md files, and broken file references all cause skills to fail or misfire. This Skill guides the creation of spec-compliant skills and validates them before use. ## Core Features & Use Cases - Skill Scaffolding Guidance: Step-by-step workflow for choosing valid names, writing activation-focused descriptions, and structuring SKILL.md with optional scripts/, references/, and assets/ directories. - Automated Validation: A Python validator checks directory structure, YAML frontmatter, name constraints, description length, and referenced file existence. - Pattern Library: Reference documentation covers description-writing patterns, workflow patterns (checklists, validation loops, plan-validate-execute), and a complete SKILL.md template. - Use Case: You want to package your team's database migration procedure as a reusable agent skill. Use this Skill to draft the SKILL.md, apply gotchas and checklist patterns, then run the validator to confirm it passes all spec constraints. ## Quick Start Ask the agent to create a new Agent Skill for your task and validate it with the bundled validation script.

Frequently Asked Questions about create-agent-skill

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

FAQPage Schema
How do I create an Agent Skill with SKILL.md?▼

Create a directory matching your skill name, add a SKILL.md file with YAML frontmatter containing name and description fields, then write Markdown instructions in the body. Optionally add scripts/, references/, and assets/ directories for supporting files.

How do I validate an Agent Skill against the specification?▼

Run the bundled validate-skill.py script with the skill directory path as an argument. It checks directory structure, YAML frontmatter validity, name constraints, description length, and whether referenced files exist, returning exit code 0 on success.

What are the naming rules for Agent Skills?▼

Skill names must be 1-64 characters, use only lowercase letters, numbers, and hyphens, and match the parent directory name exactly. Names cannot start or end with a hyphen or contain consecutive hyphens or underscores.

Why is my skill not activating for relevant user prompts?▼

Activation depends on the description field, which agents use to decide when to load a skill. Vague descriptions like "helps with PDFs" fail to trigger; write imperative, specific descriptions listing capabilities and trigger contexts, then iterate with real test prompts.

What Python version is required for the skill validation script?▼

The validate-skill.py script requires Python 3.8 or later and the PyYAML package. It uses PEP 723 inline metadata, so it can be run directly with uv or pipx without manual dependency installation.