skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

create-skill

Creates Markdown-based agent skills with enforced SKILL.md structure and YAML frontmatter.

Updated May 18, 2025
Search Tags:#documentation#markdown#agent skills#skill authoring#workflow templates#yaml frontmatter#cursor
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill create-skill-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills-cursor/create-skill
Command: npx skills add https://github.com/nthpaul/dotfiles --skill create-skill-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

create-skill helps you author effective Cursor Agent Skills by providing a consistent, ready-to-follow structure and the key questions to answer before writing SKILL.md.

Core Features & Use Cases

  • Skill authoring guidance: Walks you through what the skill should cover (purpose, scope, triggers, required knowledge, and output preferences).
  • Correct placement rules: Explains where skills may be stored (personal vs project) and warns against using the reserved internal directory.
  • Reliable SKILL.md formatting: Establishes the required YAML frontmatter (at least name and description) and the recommended body structure, including the optional reference/examples/scripts pattern.

Quick Start

Ask the agent to create a new skill named create-skill for your workflow, stored in project scope (.cursor/skills/), including only the sections you specify in the SKILL.md body.

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 Agent Skill using markdown?▼

To create a Cursor Agent Skill, you author a SKILL.md file with required YAML frontmatter including name and description, then define the skill's purpose, scope, triggers, and output preferences in the body.

What's the best way to structure a SKILL.md file for project workflows?▼

Structure a SKILL.md file by starting with YAML frontmatter for name and description, then organizing the body with purpose, scope, triggers, required domain knowledge, and optional reference, examples, or scripts sections.

Where should I store markdown agent skills in a Cursor project?▼

Store markdown agent skills in either personal or project scope directories, such as .cursor/skills/ for project-level access, while avoiding any reserved internal directories used by the system.

What sections do I need to define when authoring a new workflow template?▼

When authoring a workflow template, define the skill's purpose, scope, triggers, required domain knowledge, and output preferences to ensure the agent understands exactly when and how to apply the instructions.

Can I use YAML frontmatter to configure agent skill behavior in Cursor?▼

Yes, YAML frontmatter configures agent skill behavior by requiring at minimum a name and description field, which tells the Cursor agent what the skill does and when to apply it.

Why does my Cursor agent skill documentation fail to trigger correctly?▼

Skill documentation may fail to trigger if the YAML frontmatter lacks the required name and description fields, or if the body lacks clear triggers and scope definitions needed for agent recognition.

Related Skills

Explore More Content & Communication Skills→
rkz91rkz91
264

create-rule

Create and enforce Cursor rules in .cursor/rules/ with .mdc files.

Community
Intermediate
Brendon3578Brendon3578

create-skill

Guide creation of Cursor Agent Skills using the SKILL.md format.

Community
Intermediate
rkz91rkz91
264

create-skill

Create and validate Cursor Skills with SKILL.md frontmatter and documentation templates.

Community
Intermediate
anderson-0anderson-0
4

writing-skills

Create and validate AI agent skill documentation with SKILL.md metadata.

Community
Advanced