create-skill

Name: create-skill
Availability: InStock
Author: liuharry1

Outline SKILL.md structure and frontmatter for Cursor Skills.

4|Updated Mar 14, 2026

Search Tags:#workflow #documentation #markdown #skill #ai-assistant #skill-creation #cursor

Ready to run

npx skills add https://github.com/LiuHarry1/ai_coding_agent_intro --skill create-skill-liuharry1

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/LiuHarry1/ai_coding_agent_intro/tree/main/deploy/workspace-seed/.ai-agent/skills/create-skill
Command: npx skills add https://github.com/LiuHarry1/ai_coding_agent_intro --skill create-skill-liuharry1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Authoring Cursor Skills can be inconsistent and hard to validate; this guide provides a structured approach to define SKILL.md with the required frontmatter and a clear, minimal layout.

Core Features & Use Cases

Enforces a YAML frontmatter with the required fields (name, description) and a concise narrative describing when to use the skill
Outlines the recommended directory layout (scripts/, references/, assets/) and supports progressive disclosure for detailed guidance
Helps in validating and discovering skills across personal ( ~/.cursor/skills/ ) and project ( .cursor/skills/ ) stores

Quick Start

Create a new skill folder with SKILL.md frontmatter and follow the documented structure to add optional components as needed.

Frequently Asked Questions about create-skill

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

FAQPage Schema

How do I create a new Cursor skill with the correct SKILL.md structure?▼

To create a Cursor skill, author a SKILL.md file with required YAML frontmatter including name and description fields. Follow the recommended directory layout with scripts/, references/, and assets/ folders, adding optional components as needed for your specific skill requirements.

What is the required frontmatter format for a Cursor SKILL.md file?▼

Cursor SKILL.md frontmatter requires name and description fields in YAML format. The description must be concise with progressive disclosure, providing a clear narrative of when to use the skill for proper validation and discovery across personal and project skill repositories.

Where should I store Cursor skills for personal versus project use?▼

Cursor skills for personal use belong in ~/.cursor/skills/ directory, while project-specific skills reside in .cursor/skills/ within your project root. This separation enables proper skill discovery and validation across different contexts.

What is the recommended directory layout for a Cursor skill?▼

The recommended Cursor skill directory layout includes a root SKILL.md file with optional scripts/, references/, and assets/ subdirectories. This minimal structure supports progressive disclosure, allowing detailed guidance to be organized and accessible.

Does my Cursor skill description need to follow any specific format?▼

Cursor skill descriptions must be concise and use progressive disclosure. This approach provides essential context about when to use the skill upfront, with detailed guidance revealed through optional components and reference files as needed.

How do I validate that my SKILL.md file meets Cursor skill standards?▼

Validate your SKILL.md file by checking that frontmatter includes required name and description fields, the description is concise with progressive disclosure, and the directory layout follows the minimal structure with optional scripts/, references/, and assets/ folders.