skills.rest
NachoOsella
NachoOsellaCOMMUNITY
Explore all skills by this author →
GitHub

skill-creator

Validate Pi skill directories for frontmatter and structure compliance.

6|Updated Jan 6, 2026
Search Tags:#automation#templates#validation#skill#frontmatter#skeleton#pi
One-click install
npx skills add https://github.com/NachoOsella/DotFiles-V4 --skill skill-creator-nachoosella
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/NachoOsella/DotFiles-V4/tree/main/pi/.pi/agent/skills/skill-creator
Command: npx skills add https://github.com/NachoOsella/DotFiles-V4 --skill skill-creator-nachoosella

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Pi skill authors and teams struggle to ensure that Skill units adhere to the official Agent Skills format, frontmatter requirements, and discovery-ready structure.

Core Features & Use Cases

  • Validate SKILL.md frontmatter for required fields and naming rules.
  • Ensure README.md includes an Installation section and a concise summary.
  • Detect unknown frontmatter fields and type mismatches to maintain consistency.
  • Detected issues surface as errors and warnings to guide correction before packaging skills.

Quick Start

Create a new skill directory named after the skill, add a SKILL.md with proper frontmatter, include optional resources if needed, and run the validator to confirm compliance.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I validate Pi skill frontmatter for required fields and naming rules?▼

Pi skill structure validation checks SKILL.md frontmatter for required fields, naming rules, and type correctness. It ensures README.md presence with an Installation section and detects unknown fields to maintain schema conformance.

What is the correct structure for a Pi skill directory to ensure discoverability?▼

A valid Pi skill directory requires a SKILL.md with proper frontmatter and a README.md with an Installation section and concise summary. Optional resources can be included, and the validator confirms schema conformance for safe activation.

How do I detect unknown frontmatter fields and type mismatches in my skills?▼

Run the validator on your skill directory to detect unknown frontmatter fields and type mismatches. It enforces schema conformance, identifies unknown fields, and outputs errors and warnings to correct issues before packaging.

Do I need pyyaml to validate Pi skill directories for correct frontmatter?▼

Yes, pyyaml is required to validate Pi skill directories. This dependency enables the tool to parse YAML frontmatter in SKILL.md files, check type correctness, enforce naming rules, and validate overall structure.

Why does my Pi skill fail validation before packaging?▼

Pi skill validation fails when SKILL.md frontmatter contains missing required fields, naming rule violations, type mismatches, or unknown fields. A missing README.md or Installation section also triggers errors that block safe activation.

Related Skills

Explore More Software Engineering Skills→
chancetop-comchancetop-com
18

wrong-name-here

Compare SKILL.md frontmatter name against the containing directory name.

Official
Basic
legoutlegout
3

template-skill

Create custom agent skills with a standard SKILL.md structure.

Community
Basic
salverius-techsalverius-tech

docs-workflow

Enforce documentation standards and automate validation for Markdown files.

Community
Intermediate
oimiragieooimiragieo
36

code-style-validator

Analyze ASTs to detect naming, formatting, and structural inconsistencies in code.

Community
Advanced