skill-creator

Create and validate skill packages with SKILL.md frontmatter, scripts, and references.

1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/waiyanphyo999/telegram-bot-deploy --skill skill-creator-waiyanphyo999
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/waiyanphyo999/telegram-bot-deploy/tree/main/skills/skill-creator
Command: npx skills add https://github.com/waiyanphyo999/telegram-bot-deploy --skill skill-creator-waiyanphyo999

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building reusable AI agent skills requires consistent structure, valid YAML frontmatter, and well-organized resources, which is error-prone when done manually. This Skill provides a guided workflow, scaffolding scripts, and validation to produce correctly structured skill packages. ## Core Features & Use Cases - Skill Scaffolding: Run init_skill.py to generate a complete skill directory with SKILL.md template and example scripts, references, and templates. - Design Guidance: Follow documented principles for concise instructions, progressive disclosure, workflow patterns, and output patterns. - Automated Validation: Run quick_validate.py to check frontmatter fields, naming conventions, and description constraints before delivery. - Use Case: When asked to build a new skill for PDF processing, initialize the directory, customize the template, consult the reference guides, and validate the result before delivering it to the user. ## Quick Start Create a new skill named data-analyzer by running the init script, then edit the generated SKILL.md and validate it with the quick validation script.

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 skill from scratch?

Run init_skill.py with a hyphen-case skill name to generate a directory containing a SKILL.md template plus example scripts, references, and templates folders. Then edit the TODO placeholders, customize resources, and validate before delivery.

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

SKILL.md requires YAML frontmatter with name and description fields, followed by Markdown instructions. The name must be hyphen-case and under 64 characters, and the description must explain what the skill does and when to use it.

How do I validate a skill before delivering it?

Run quick_validate.py with the skill name or absolute path. It checks that SKILL.md exists, the frontmatter parses as valid YAML, required fields are present, and naming and description length constraints are met.

When should I split skill content into reference files?

Split content when SKILL.md approaches 500 lines or when the skill covers multiple domains or variants. Keep the core workflow in SKILL.md and move variant-specific details into references, linking them clearly with guidance on when to read each file.

What are the limitations of skill frontmatter fields?

Only name, description, license, allowed-tools, and metadata properties are allowed in frontmatter. Descriptions cannot contain angle brackets and must stay under 1024 characters, and names cannot start or end with hyphens.