creating-skills

Create Claude agent skills with SKILL.md templates and validate them using verify.py integration.

27|11|Updated Dec 21, 2025

Search Tags:#scaffolding #verification #skill #SKILL.md #frontmatter #package_skill #init_skill

One-click install

npx skills add https://github.com/mjunaidca/mjs-agent-skills --skill creating-skills-mjunaidca

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: creating-skills
Source: https://github.com/mjunaidca/mjs-agent-skills/tree/main/.claude/skills/creating-skills
Command: npx skills add https://github.com/mjunaidca/mjs-agent-skills --skill creating-skills-mjunaidca

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill guides users through creating effective Claude Skills, including SKILL.md structure, YAML frontmatter, resource layout, and verification tooling. It helps ensure skills are well-formed and easy to validate before deployment.

Core Features & Use Cases

Step-by-step patterns for skill creation: using the SKILL.md template, and resource directories
Guidance on frontmatter requirements, description quality, and validation tooling
Example scaffolding for scripts, references, and assets
Use case: designing a new skill from scratch and ensuring it can be packaged

Quick Start

Run the provided init_skill.py to create a new skill skeleton under skills/ or to package an existing skill.

Frequently Asked Questions about creating-skills

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

FAQPage Schema

How do I create a new Claude Skill from scratch?▼

Create a new Claude Skill using the init_skill.py script, which scaffolds a skill skeleton with SKILL.md structure, YAML frontmatter (name and description), and resource directories for scripts and references. The tool generates a well-formed template you can customize for your use case.

What should I include in a SKILL.md file?▼

SKILL.md requires YAML frontmatter with name and description fields, followed by structured guidance for skill functionality. Include sections for core features, use cases, and quick-start instructions. The frontmatter metadata ensures proper packaging and enables validation through verify.py.

How do I validate my skill structure before deployment?▼

Run verify.py to check SKILL.md metadata consistency, frontmatter completeness, and resource packaging rules. This validation catches structural issues, missing descriptions, and bundled asset problems early, ensuring your skill meets deployment requirements.

What are the resource packaging requirements for skills?▼

Skills must organize bundled resources into scripts and references directories with proper structure. SKILL.md guides resource layout, naming conventions, and asset organization. Validation tooling checks that all referenced resources exist and follow packaging rules.

Can I update an existing skill's metadata and structure?▼

Yes. Use init_skill.py to audit or re-package an existing skill, updating SKILL.md metadata, frontmatter fields, and resource organization. The tool supports both new skill creation and modification of deployed skills with verification checks.

Do I need prior knowledge to create a skill?▼

Understanding YAML frontmatter syntax and basic file structure helps, but the init_skill.py tool provides templates and step-by-step patterns that guide you through skill creation. The quick_validate dependency checks your work, reducing setup barriers.