skills.rest
ArangoGutierrez
ArangoGutierrezCOMMUNITY
Explore all skills by this author →
Website𝕏@CarlosEArangoGitHub

create-skill

Guides authoring of Cursor Agent Skills with SKILL.md structure and frontmatter conventions.

3|Updated Jul 2, 2026
Search Tags:#workflow#prompt engineering#agent skills#skill authoring#frontmatter#skill.md#cursor
One-click install
npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill create-skill-arangogutierrez
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: create-skill
Source: https://github.com/ArangoGutierrez/claude-toolkit/tree/main/.cursor/skills-cursor/create-skill
Command: npx skills add https://github.com/ArangoGutierrez/claude-toolkit --skill create-skill-arangogutierrez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a well-structured Agent Skill for Cursor requires knowing the SKILL.md format, frontmatter rules, description best practices, and directory layout — this Skill encodes all of that guidance so new skills are discoverable and effective from the start. ## Core Features & Use Cases - Structured authoring workflow: Walks through discovery, design, implementation, and verification phases when creating a new skill. - Frontmatter and description rules: Enforces naming constraints, third-person descriptions with WHAT and WHEN, and the 500-line SKILL.md limit. - Reusable patterns: Provides template, examples, workflow, conditional, and feedback-loop patterns plus anti-patterns to avoid. - Use Case: A user asks to create a project skill that reviews PRs against team standards; this Skill gathers requirements, drafts the name and description, and produces a compliant SKILL.md with supporting reference files. ## Quick Start Ask the agent to create a new Cursor skill for your workflow, for example a commit-message generator, and let it guide you through the SKILL.md setup.

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?▼

Create a directory containing a SKILL.md file with YAML frontmatter defining a name and description, followed by markdown instructions. Store it in ~/.cursor/skills/ for personal use or .cursor/skills/ for project sharing.

What should a SKILL.md description include?▼

Write the description in third person with both what the skill does and when to use it, including specific trigger terms. Keep it under 1024 characters so the agent can decide when to apply the skill.

Where should Cursor skills be stored?▼

Personal skills go in ~/.cursor/skills/skill-name/ and project skills go in .cursor/skills/skill-name/. Never create skills in ~/.cursor/skills-cursor/, which is reserved for Cursor's internal built-in skills.

How long can a SKILL.md file be?▼

Keep the main SKILL.md under 500 lines for optimal performance. Move detailed documentation into reference files linked one level deep so the agent reads them only when needed.

When should a skill include utility scripts?▼

Add scripts for fragile or consistency-critical operations where generated code would be unreliable, such as validation or form analysis. Scripts save tokens, ensure consistency, and should document required packages and error handling.

Related Skills

Explore More Software Engineering Skills→
engineai-nzengineai-nz

browse

Browse curated skill materials and relevant files to surface content for user questions.

Official
Basic
cody-hutsoncody-hutson

pmo-skill-refiner-selftest-canary

Verify consistency between PMO skill directories and deploy.sh skill arrays.

Community
Advanced
DaFumDaFum
1

skill-aligner

Rewrites SKILL.md files to align terminology and metadata with repository conventions.

Community
Advanced
519lab519lab
2

thoth-agent-skill-authoring

Automate authoring and validation of SKILL.md frontmatter and structure for Thoth Agent.

Official
Advanced