create-skill

Generate standardized SKILL.md scaffolding with YAML frontmatter for new agent skills.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill create-skill-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/create-skill
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill create-skill-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the guesswork and inconsistencies involved in creating new agent skills by generating a correctly structured SKILL.md with required frontmatter and recommended operational sections.

Core Features & Use Cases

  • Skill scaffolding: Produces the standardized directory layout and SKILL.md frontmatter so skills are discoverable.
  • Specification alignment: Guides validation steps (naming rules, frontmatter presence, size limits) to ensure compatibility with the Agent Skills spec and repository conventions.
  • Safe boundaries: Clearly states when not to use the skill (e.g., modifying existing skills) to prevent accidental divergence.

Quick Start

Use this skill to scaffold a new skill directory named like skills/<skill-name>/ and generate a SKILL.md using the required YAML frontmatter with name and description for that directory.

Frequently Asked Questions about create-skill

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

FAQPage Schema
How do I scaffold a new agent skill with the correct directory structure?

To scaffold a new agent skill, generate a standardized skills/<skill-name>/ directory containing a SKILL.md file with required YAML frontmatter and recommended body sections to ensure discoverability and spec compliance.

What YAML frontmatter is required for an agent skill to be discoverable?

Required YAML frontmatter for agent skill discovery includes a valid name and description. Ensuring frontmatter presence and adhering to naming rules meets repository-specific validation requirements.

Can I use this to modify an existing SKILL.md file?

No, you should not use this to modify existing skills. It is designed specifically for starting new skills from scratch to prevent accidental divergence from the standardized directory layout.

What is the best way to validate agent skill metadata before publishing?

The best way to validate agent skill metadata is to enforce naming rules, frontmatter presence, and size limits. This ensures compatibility with the Agent Skills spec and repository conventions.

Do I need to manually set up optional scripts and assets directories when creating an agent skill?

No, you do not need to manually set them up. Scaffolding a new skill automatically establishes the directory structure and conventions for optional scripts, references, and assets alongside the SKILL.md entry point.