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
Download the bundle
Visit impeccable.style and download the Cursor bundle, or copy from the repository:
Enable Agent Skills
- Switch to Nightly channel in Cursor Settings → Beta
- Enable Agent Skills in Cursor Settings → Rules
File Structure
Cursor organizes skills using the Agent Skills directory structure:- 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:
Writing Argument-Friendly Prompts
Impeccable skills are designed to work with or without appended arguments:{{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’sreference/ subdirectory. The frontend-design skill includes 7 reference files covering typography, color, spatial design, and more.
Usage Examples
Basic Command
Focused Command
Multi-Step Workflow
Available Skills
Impeccable includes 17 user-invokable skills plus the comprehensivefrontend-design reference skill:
| Skill | Purpose |
|---|---|
/audit | Technical quality checks (a11y, performance, responsive) |
/critique | UX design review (hierarchy, clarity, emotional resonance) |
/normalize | Align with design system standards |
/polish | Final pass before shipping |
/distill | Strip to essence |
/clarify | Improve unclear UX copy |
/optimize | Performance improvements |
/harden | Error handling, i18n, edge cases |
/animate | Add purposeful motion |
/colorize | Introduce strategic color |
/bolder | Amplify boring designs |
/quieter | Tone down overly bold designs |
/delight | Add moments of joy |
/extract | Pull into reusable components |
/adapt | Adapt for different devices |
/onboard | Design onboarding flows |
/teach-impeccable | One-time setup: gather design context |
Quirks & Limitations
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
Skills Not Loading
If skills exist but aren’t recognized:- Check YAML frontmatter is valid (no syntax errors)
- Ensure
namefield matches directory name - Look for file permission issues
- 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
Thefrontend-design skill provides deep domain expertise. User-invokable skills explicitly invoke it:
3. Combine Commands
Chain multiple skills for complex workflows:/audit- Find issues/normalize- Fix inconsistencies/polish- Final cleanup/animate- Add motion
