How to Use Cursor Skills: The Complete Guide

Cursor skills help you create and use reusable workflows in Cursor, from built-in capabilities to custom skill creation. For users who want a faster way to build skills from existing content, Kimi's document-to-skills feature can directly convert documents into structured skills.

10 min read2026-06-29
How to use skills in Cursor

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.

Cursor AI coding platform

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.

Creating a .cursor folder in the project root directory

Step 2: Add a skills directory

Next, create a skills folder inside the .cursor. This directory will contain all of your custom skills.

Adding a skills folder inside the Cursor configuration directory

Step 3: Create a folder for each skill

Each skill should have its own folder inside the skills directory. For example:

  • api-creation-skill

  • documentation-creator

  • code-review-assistant

Separating skills into individual folders helps prevent conflicts and makes updates easier as your skill library grows

Organizing multiple custom Cursor skills in separate folders

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.

Creating a skill.md file inside a custom Cursor skill folder

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.

Core structure of a Cursor skill definition file

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

Adding templates and validation rules to a Cursor skill

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.

Selecting and using a custom skill in Cursor Chat

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.

Cursor executing a workflow using a custom skill

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.

SkillPurpose
canvasCreate/edit .canvas.tsx, open visual Canvas (charts, tables, analysis panels, etc.) alongside chat
sdkUse Cursor SDK (@cursor/sdk/ cursor-sdk) to call Agent in scripts, CI, and automation
babysitMaintain PR mergeable status: handle comments, resolve conflicts, fix CI
statuslineConfigure CLI custom status bar (statusLinein~/.cursor/cli-config.json)
split-to-prsSplit current changes into multiple small, reviewable PRs
update-cursor-settingsModify IDE settings (settings.json: theme, font, formatting, etc.)
update-cli-configModify CLI configuration (~/.cursor/cli-config.json: permissions, approval mode, vim, etc.)
shellHandle /shell command, execute subsequent text as a literal shell command
migrate-to-skillsMigrate .cursor/rules/.mdc and .cursor/commands/.md to Skills format
create-subagentCreate a custom subagent (dedicated AI sub-agent)
create-ruleCreate Cursor Rules (.cursor/rules/, AGENTS.md, etc.)
create-hookCreate Cursor Hooks (hooks.json, execute custom logic before/after Agent events)
create-skillCreate new Agent Skill (write SKILL.mdstructure and specifications)

External skills that work in Cursor

SkillDescriptionGitHub link
best-of-n-solvingTry 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-exploringExplore 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-testsSet 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-authAdd 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-stripeIntegrate Stripe checkout, subscriptions, webhooks, and customer portal.https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-stripe/SKILL.md
adding-dockerDockerize 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-analyticsAdd 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-trackingAdd Sentry crash reporting, performance monitoring, and source maps.https://github.com/spencerpauly/awesome-cursor-skills/blob/main/resources/adding-error-tracking/SKILL.md
auditing-securitySystematic 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-performanceProfile 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-tailwindConvert 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-imagesGenerate 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-testingDiscover 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-prCreate 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-prMonitor 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.

Accessing the document to the skills tool in Kimi

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.

Uploading a document to convert it into Skill in Kimi

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.

Create and use your skills in Kimi

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.

Download your skill in Kimi

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.

FAQ

Where are Cursor skills stored?
Cursor skills are typically stored inside your local project or Cursor's workspace configuration. In most setups, they live as structured files or folders within the project directory (often similar to .cursor/ or a skills/config folder). If synced, they can also be managed through your Cursor account settings. This makes them available across sessions when working on the same project.
Are Cursor skills automatic?
Yes, Cursor skills can work automatically depending on how they are configured. When enabled, they can detect context in your codebase and apply relevant instructions without manual prompting. However, not all skills run automatically; some require explicit triggering by the user. It depends on the skill type and setup.
Can Cursor skills be customized?
Yes, Cursor skills are fully customizable based on your workflow needs. You can edit instructions, adjust behavior rules, and define how the skill should respond in different scenarios. Developers often tailor skills for specific frameworks, coding standards, or automation tasks. This flexibility allows teams to build personalized AI-assisted development workflows.