skill-creator

Create, validate, and package AgentSkill directories with SKILL.md frontmatter.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill skill-creator-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/skill-creator
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill skill-creator-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Writing well-formed AgentSkills requires knowing the SKILL.md frontmatter rules, directory conventions, and validation constraints; this Skill codifies those rules and ships scripts that scaffold, validate, and package skills so authors avoid malformed frontmatter and inconsistent structure. ## Core Features & Use Cases - Skill scaffolding: init_skill.py generates a new skill directory with a templated SKILL.md and optional scripts/, references/, and assets/ folders, including example placeholder files. - Frontmatter validation: quick_validate.py checks name/description presence, hyphen-case naming, length limits, and allowed frontmatter keys, with a fallback parser when PyYAML is unavailable. - Packaging: package_skill.py bundles a validated skill into a distributable .skill zip archive with deterministic entry ordering and symlink/escape protections. - Use Case: When asked to create a new skill for PDF tooling, run the initializer to scaffold the directory, edit SKILL.md per the hard rules, then validate and package it for distribution. ## Quick Start Create a new skill named pdf-tools under the skills directory, then validate its SKILL.md frontmatter and package it into a .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 with SKILL.md?

Run init_skill.py with a skill name and output path to scaffold a directory containing a templated SKILL.md. Optionally pass --resources scripts,references,assets and --examples to pre-create resource folders with placeholder files.

How to validate SKILL.md frontmatter before publishing?

Run quick_validate.py against the skill directory. It checks that frontmatter exists, parses as YAML, contains name and description, uses hyphen-case names under 64 characters, and includes only allowed keys.

What fields are allowed in SKILL.md frontmatter?

The validator permits name, description, homepage, license, allowed-tools, user-invocable, and metadata. Name and description are mandatory; descriptions must be non-empty, under 1024 characters, and contain no angle brackets.

Does quick_validate.py work without PyYAML installed?

Yes, it falls back to a minimal built-in parser that handles simple key-value frontmatter and indented multiline values. Complex YAML syntax beyond that requires installing PyYAML.

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

Run package_skill.py with the skill folder path and an optional output directory. It validates the skill first, then writes a zip-based .skill archive with deterministic entry ordering while skipping symlinks and excluded directories.

Why does skill packaging skip some files?

The packager skips symlinks, version-control directories like .git, __pycache__, and node_modules for security and reproducibility. It also rejects any file whose resolved path escapes the skill root.