Skip to main content

Overview

Cursor uses the Agent Skills Standard to organize skills and reference files. Impeccable transforms its rich source format into Cursor-compatible skills that work seamlessly with Agent mode.
Agent Skills require Cursor Nightly channel. Enable in Settings → Beta → Nightly, then enable Agent Skills in Settings → Rules.

Installation

1

Download the bundle

Visit impeccable.style and download the Cursor bundle, or copy from the repository:
2

Enable Agent Skills

  1. Switch to Nightly channel in Cursor Settings → Beta
  2. Enable Agent Skills in Cursor Settings → Rules
3

Verify installation

Open Agent mode and type /audit - if the command is recognized, installation succeeded.

File Structure

Cursor organizes skills using the Agent Skills directory structure:
Each skill directory contains:
  • SKILL.md - Main skill file with YAML frontmatter
  • reference/ (optional) - Domain-specific reference documents

Skill Format

Cursor skills use YAML frontmatter with the following structure:

How Arguments Work

Cursor does not support arguments in frontmatter. This is a key limitation compared to other providers.

Invocation Styles

When you use a command like /audit, Cursor has two ways to handle optional arguments:
If you provide text after the command, Cursor appends it to the skill prompt as context. The skill must be written to handle both cases gracefully.

Writing Argument-Friendly Prompts

Impeccable skills are designed to work with or without appended arguments:
The {{area}} placeholder gets replaced during build, but the surrounding text ensures the skill works whether you type /audit or /audit checkout form.

Provider-Specific Transformations

The build system applies these transformations for Cursor:

1. Strip Advanced Metadata

Cursor only supports basic frontmatter fields:

2. Replace Placeholders

Argument placeholders are transformed for append-style invocation:

3. Preserve Reference Files

Reference files are copied as-is into each skill’s reference/ subdirectory. The frontend-design skill includes 7 reference files covering typography, color, spatial design, and more.

Usage Examples

Basic Command

Runs a comprehensive audit of the entire interface.

Focused Command

Aligns the checkout form with design system standards.

Multi-Step Workflow

Available Skills

Impeccable includes 17 user-invokable skills plus the comprehensive frontend-design reference skill:

Quirks & Limitations

No Argument Syntax: Unlike Claude Code or Gemini, Cursor doesn’t support {{arg}} placeholders in skill bodies. Arguments must be appended after the command.

Append-Only Arguments

Cursor treats everything after /command as additional context:

No Argument Validation

Cursor doesn’t validate required vs optional arguments. Skills must handle any input gracefully.

Skill Discovery

Agent Skills are automatically discovered from .cursor/skills/. No manual registration needed.

Nightly Channel Requirement

Agent Skills are currently only available in Cursor Nightly. If you’re on the stable channel, commands won’t be recognized.

Troubleshooting

Commands Not Recognized

1

Check Nightly channel

Settings → Beta → Nightly
2

Enable Agent Skills

Settings → Rules → Agent Skills (toggle on)
3

Verify file structure

Ensure .cursor/skills/audit/SKILL.md exists in your project root
4

Restart Cursor

Fully quit and relaunch Cursor to reload skills

Skills Not Loading

If skills exist but aren’t recognized:
  1. Check YAML frontmatter is valid (no syntax errors)
  2. Ensure name field matches directory name
  3. Look for file permission issues
  4. Check Cursor’s output panel for error messages

Arguments Not Working

Remember: Cursor appends arguments, doesn’t inject them. Write skills that work with or without trailing context.

Best Practices

1. Design for Flexibility

Write skills that work with zero, one, or many appended words:

2. Use Reference Skills

The frontend-design skill provides deep domain expertise. User-invokable skills explicitly invoke it:

3. Combine Commands

Chain multiple skills for complex workflows:
  1. /audit - Find issues
  2. /normalize - Fix inconsistencies
  3. /polish - Final cleanup
  4. /animate - Add motion

4. Stay Specific

When appending context, be specific:

Learn More