create-skill

Create, document, and validate Cursor Skills with SKILL.md frontmatter.

5|2|Updated Jan 10, 2017

Search Tags:#workflow #templates #documentation #validation #frontmatter #skill-creation #cursor

Ready to run

npx skills add https://github.com/brujack/dotfiles --skill create-skill-brujack

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/brujack/dotfiles/tree/main/.cursor/skills-cursor/create-skill
Command: npx skills add https://github.com/brujack/dotfiles --skill create-skill-brujack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide helps users design and document Cursor Skills by outlining a repeatable process: discovery, design, and implementation, ensuring skills are well-structured, discoverable, and safe.

Core Features & Use Cases

Provides a proven workflow for authoring SKILL.md files with proper frontmatter and clear instructions.
Defines how to organize optional references, scripts, and assets to support skills.
Serves as an onboarding resource for new team members to understand Cursor Skill standards and best practices.

Quick Start

Draft your SKILL.md with frontmatter and a clear description, then create a new skill directory with any needed references or scripts.

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 Cursor Skill with valid SKILL.md frontmatter?▼

Creating a Cursor Skill requires drafting a SKILL.md file with valid frontmatter that includes a name and description, followed by structuring optional scripts, references, or assets within a dedicated skill directory to support the skill's execution.

What is the standard workflow for documenting and validating Cursor Skills?▼

The standard workflow for Cursor Skills follows a three-phase process: discovery, design, and implementation. This framework ensures your skills are well-structured, discoverable, and safe by applying consistent naming, frontmatter validation, and clear documentation practices.

Do I need to include scripts and references when authoring a SKILL.md file?▼

Including scripts and references is optional when authoring a SKILL.md file. The only strict requirements are a clear description and valid frontmatter, while optional resources can be added to further support and enhance the skill's functionality.

What's the best way to structure a Cursor Skill for team onboarding?▼

The best way to structure a Cursor Skill for team onboarding is to follow the standardized discovery, design, and implementation workflow. This ensures your SKILL.md file contains clear instructions and proper frontmatter, serving as a reliable resource for new team members.

Why does my Cursor Skill require a clear description in the frontmatter?▼

A clear description in the frontmatter is required to ensure your Cursor Skill is discoverable and understandable. It defines the skill's core task during the discovery phase, allowing both users and the system to accurately identify its purpose.