[ ABORT TO HUD ]
SEQ. 1
SEQ. 2

Agent Skills & Slash Commands

🧩 Skills, Hooks & Customization 20 min 450 BASE XP⌨ HANDS-ON LAB

Reusable Expertise for Your Agent

Agent Skills package domain knowledge into folders the agent can discover and use. Cursor implements the open Agent Skills standard (agentskills.io) - the same format used by other AI coding tools, so skills are portable across ecosystems.

Anatomy of a Skill

.cursor/skills/deploy-checklist/
├── SKILL.md          # required: instructions + YAML frontmatter
├── scripts/          # optional: executable helpers
├── references/       # optional: docs loaded on demand
└── assets/           # optional: templates, images
---
name: deploy-checklist
description: Pre-deployment verification steps for this repo
---
# Deploy Checklist
1. Run the full test suite
2. Verify env config against .env.example
3. Build locally before pushing to the platform

The frontmatter also supports paths globs (auto-activate the skill for matching files) and disable-model-invocation (make it slash-command-only). Skills live at project level (.cursor/skills/, .agents/skills/) or user level (~/.cursor/skills/), with nested directories for monorepo scoping - and Cursor even reads skills from compatible tools' directories.

Built-In Slash Commands

Type / in the agent input to invoke built-in skills:

CommandWhat It Does
/create-skill, /create-rule, /create-hookScaffold a new skill, rule, or hook
/review, /review-security, /review-bugbotIn-editor code review before you push
/loopRepeat a prompt on a schedule until a condition is met
/split-to-prsBreak a big diff into reviewable stacked PRs
/automateCreate an always-on Automation (see Cloud Agents)
/migrate-to-skillsConvert legacy rules/commands into the skills format

The Customize Page

Since Cursor Agent Mode, the Customize page is one place to manage plugins, skills, MCP servers, subagents, rules, commands, and hooks - at user, team, or workspace scope - plus a marketplace with a leaderboard of popular extensions.

Pro Tip: Rules vs Skills - rules are always-available context; skills are on-demand capabilities with scripts and reference material. If your instructions include "how to do X step-by-step", it probably wants to be a skill.
⌨ HANDS-ON LABScaffold Custom Agent Skill
⭐ +150 XP

Skills give Cursor's agent specialized task workflows. Scaffold a new audit skill in .cursor/skills/audit/SKILL.md.

1Create the skill directory and initialize SKILL.md with markdown frontmatter.
lab-sandbox — simulated environment
INFINITY LAB SANDBOX v2.6 — simulated shell
Type the command for the current objective. Helpers: "hint", "solution", "clear".
$
OBJECTIVE 1 / 1 — type "hint" if stuck
SYNAPSE VERIFICATION
QUERY 1 // 3
What is the required file at the heart of every Agent Skill?
skill.json
SKILL.md with YAML frontmatter
index.ts
README.md