skill-creator

Create, validate, and package AgentSkills with scripts, references, and assets.

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill skill-creator-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/skill-creator
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill skill-creator-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Designing a well-structured AgentSkill requires knowing frontmatter rules, naming conventions, resource organization, and packaging steps. This Skill guides the agent through the full lifecycle of creating, editing, validating, and packaging skills so they are discoverable and distributable. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.py to generate a SKILL.md template with proper YAML frontmatter and optional scripts/, references/, and assets/ directories. - Design Guidance: Apply progressive disclosure principles, naming conventions, and description-writing rules so skills trigger correctly and stay concise. - Validation & Packaging: Use package_skill.py to validate frontmatter, naming, and structure, then produce a distributable .skill zip file. - Use Case: When asked to build a new pdf-editor skill, the agent initializes the directory, writes a compliant SKILL.md, adds a rotation script, and packages it into pdf-editor.skill. ## Quick Start Create a new skill named pdf-editor with scripts and references, then package it into a distributable .skill file.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a new AgentSkill from scratch?▼

Run scripts/init_skill.py with the skill name and output path, optionally passing --resources scripts,references,assets. It generates a SKILL.md template with proper frontmatter, which you then edit before packaging with package_skill.py.

What is the required structure of a SKILL.md file?▼

SKILL.md must start with YAML frontmatter containing name and description fields, followed by Markdown instructions. The name must be hyphen-case, match the directory name, and stay under 64 characters.

How do I package a skill into a .skill file?▼

Run scripts/package_skill.py with the skill folder path and an optional output directory. It validates the skill first, then creates a zip archive with a .skill extension; symlinks cause packaging to fail.

When should I use scripts, references, or assets in a skill?▼

Use scripts for deterministic executable code, references for documentation loaded into context on demand, and assets for files used in outputs like templates or fonts. Only create directories the skill actually needs.

Why does skill validation fail during packaging?▼

Validation fails when frontmatter is missing name or description, the name is not hyphen-case or mismatches the folder, the description contains TODO placeholders, or unexpected files exist in the skill root.