Skills reshape how developers work with AI by turning repetitive workflows into reusable, structured capabilities. As a leading AI code editor, Cursor is often the preferred tool for applying skills, but setting them up requires understanding file structure, context management, and prompt design. This guide shows how to create and configure Cursor skills, explore useful examples, and build custom skills with AI to turn best practices into reusable "muscle memory."
How to create and use skills in Cursor?
To make Cursor skills practical, you first need to understand how to set them up inside your project structure. Once the setup is in place, you can easily create, organize, and use skills to automate your development workflows. Follow these steps to create and use skills in Cursor.
Step 1: Create a .cursor folder
First, navigate to your project root directory and create a folder named .cursor. This folder stores Cursor-specific configuration files and project-level settings.
Step 2: Add a skills directory
Next, create a skills folder inside the .cursor. This directory will contain all of your custom skills.
Step 3: Create a folder for each skill
Each skill should have its own folder inside the skills directory. For example:
api-creation-skilldocumentation-creatorcode-review-assistant
Separating skills into individual folders helps prevent conflicts and makes updates easier as your skill library grows
Step 4: Add a SKILL.md file
Inside each skill folder, create a file namedSKILL.``md. This file is the standard format used to define how the skill works and when the Cursor should apply it.
Step 5: Define the core structure
Once the file is created, add the essential sections that describe the skill.
A typical SKILL.md file should include:
Title: The name of the skill.
Description: Explains when the skill should be used.
Instructions: Step-by-step guidance that the Cursor follows while performing tasks.
A clear structure helps the Cursor understand the skill's purpose and produce more consistent outputs.
Step 6: Add optional enhancements (if needed)
After defining the basics, you can strengthen the skill by adding additional sections such as:
Templates
Examples
Notes
Validation rules
Output requirements
Step 7: Use the skill in Cursor
With the skill configured, open Cursor Chat using Ctrl + I. Type / to view available skills, select the one you want to use, and then describe your task. Cursor automatically loads the instructions from the selected skill and applies them to the task.
Step 8: Let Cursor execute the workflow
AI will follow your skill rules, ask clarifying questions if needed, and generate structured outputs like APIs or documentation accordingly.
Custom skills can significantly enhance the way developers work with Cursor. By turning frequently used prompts into reusable workflows, teams can save time, maintain consistency, and streamline complex development tasks.
| Skill | Purpose |
|---|---|
| canvas | Create/edit .canvas.tsx, open visual Canvas (charts, tables, analysis panels, etc.) alongside chat |
| sdk | Use Cursor SDK (@cursor/sdk/ cursor-sdk) to call Agent in scripts, CI, and automation |
| babysit | Maintain PR mergeable status: handle comments, resolve conflicts, fix CI |
| statusline | Configure CLI custom status bar (statusLinein~/.cursor/cli-config.json) |
| split-to-prs | Split current changes into multiple small, reviewable PRs |
| update-cursor-settings | Modify IDE settings (settings.json: theme, font, formatting, etc.) |
| update-cli-config | Modify CLI configuration (~/.cursor/cli-config.json: permissions, approval mode, vim, etc.) |
| shell | Handle /shell command, execute subsequent text as a literal shell command |
| migrate-to-skills | Migrate .cursor/rules/.mdc and .cursor/commands/.md to Skills format |
| create-subagent | Create a custom subagent (dedicated AI sub-agent) |
| create-rule | Create Cursor Rules (.cursor/rules/, AGENTS.md, etc.) |
| create-hook | Create Cursor Hooks (hooks.json, execute custom logic before/after Agent events) |
| create-skill | Create new Agent Skill (write SKILL.mdstructure and specifications) |
External skills that work in Cursor
| Skill | Description | GitHub link |
|---|---|---|
| best-of-n-solving | Try multiple approaches to a hard problem in parallel using isolated git worktrees, then pick the best solution. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/best-of-n-solving/SKILL.md |
| parallel-exploring | Explore a large codebase fast by launching multiple read-only subagents that investigate different areas simultaneously. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/parallel-exploring/SKILL.md |
| adding-e2e-tests | Set up Playwright with config, example tests, page objects, and CI integration. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-e2e-tests/SKILL.md |
| adding-auth | Add OAuth login, session management, and protected routes with Auth.js (NextAuth). | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-auth/SKILL.md |
| adding-stripe | Integrate Stripe checkout, subscriptions, webhooks, and customer portal. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-stripe/SKILL.md |
| adding-docker | Dockerize any app with a multi-stage Dockerfile, docker-compose, and .dockerignore. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-docker/SKILL.md |
| adding-analytics | Add PostHog event tracking, page views, feature flags, and session replay to any web app. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-analytics/SKILL.md |
| adding-error-tracking | Add Sentry crash reporting, performance monitoring, and source maps. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-error-tracking/SKILL.md |
| auditing-security | Systematic security audit checking for OWASP Top 10 vulnerabilities, secrets exposure, and insecure patterns. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/auditing-security/SKILL.md |
| profiling-performance | Profile CPU performance of a running app using Cursor's browser profiler to capture call stacks and identify slow functions. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/profiling-performance/SKILL.md |
| converting-css-to-tailwind | Convert plain CSS stylesheets to Tailwind utility classes — selectors, media queries, pseudo-classes, animations, and arbitrary values. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/converting-css-to-tailwind/SKILL.md |
| generating-images | Generate or edit images (icons, logos, blog heroes, OG images, illustrations, mockups) using OpenAI gpt-image-2. Supports text-to-image, image-to-image, masked inpainting, and parallel batch jobs. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/generating-images/SKILL.md |
| api-smoke-testing | Discover API routes from the codebase, hit every endpoint, and report which ones return errors. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/api-smoke-testing/SKILL.md |
| creating-pr | Create clean, review-ready pull requests with conventional titles, structured descriptions, and linked issues. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/creating-pr/SKILL.md |
| babysitting-pr | Monitor an open PR for CI failures, review comments, and merge conflicts — then fix them automatically to keep the PR merge-ready. | https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/babysitting-pr/SKILL.md |
Bonus tip: Create personal skills with Kimi easily
Kimi's document-to-skills feature allows you to turn existing documents, code, or templates into reusable AI skills. Instead of only reading or summarizing files, it can extract structured workflows directly from your content and convert them into automated actions. This makes it easy to reuse processes from Office files or internal documents, helping you automate repetitive tasks without rebuilding workflows from scratch.
How to convert documents into skills?
If you already have SOPs, templates, reports, or structured files, you can directly convert them into a Skill inside Kimi. Here is how to do it.
Step 1: Access the document to the skills tool
Go to kimi.com to get started. Click on the "+" (create) button, then navigate to "Skills" and select the "Document to skills" option.
Step 2: Upload Office files
Upload your existing files like Word documents, PDFs, Excel sheets, or presentations. After uploading, clearly explain what you want Kimi to pull out, duplicate, or convert into a reusable skill. Kimi will then process the file, recognize key patterns, and extract the underlying workflow structure from your document automatically.
Step 3: Create and use your skills
Click on "Create skill" to start the generation process. Kimi will analyze your document and convert it into a structured, reusable skill, which may take a few minutes depending on the file size and complexity.
Once completed, you can open the skill to use it directly. You also have the option to modify it, copy the content, or download it as a .md file for reuse or sharing.
Key features of Kimi's document to skills tool
Now that you understand how documents can be converted into reusable skills, it's important to look at what makes this feature powerful.
Turn documents into a reusable skills & knowledge system
Kimi converts documents like SOPs, manuals, and guidelines into structured Skills. These Skills capture workflows, rules, and domain knowledge in a reusable format. Instead of static files, your documents become actionable AI instructions. This helps you reuse the same expertise across multiple tasks.
Combine custom and existing skills for better results
Kimi allows you to use multiple skills together, including your own custom skills and built-in ones. By combining different skills in a single workflow, you can produce outputs that are more aligned with your expectations and task requirements. This flexible approach makes it easier to adapt skills to different scenarios and improve overall output quality.
Conclusion
Skills make it easier to manage development tasks by packaging instructions into reusable workflows within the editor. This helps maintain consistency in outputs and reduces the need for repeated manual prompting during coding. Developers can apply the same structured logic across different projects, improving efficiency and organization. For even faster setup, tools like Kimi can convert existing documents into reusable skills, making workflow automation easier and more scalable.