# Cursor Skills System

> Authoring `.cursor/skills/` skill packs that the Cursor Agent and SDK can pick up. Use when adding reusable capabilities to a project (or user-global), structuring SKILL.md frontmatter, and pairing skills with the SDK via `local.settingSources`.

- Skill: `hktitan/cursor-skills-system` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-skills-system`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-skills-system/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-skills-system

---


# cursor-skills-system

Cursor follows the [Agent Skills spec](https://agentskills.io/specification): drop a folder in `.cursor/skills/<name>/` with a `SKILL.md` and the agent can invoke it on demand. The SDK loads project and user skills when `local.settingSources` includes the matching scope.

## When to use

- Packaging reusable instructions / scripts as a named skill
- Choosing project vs user vs team scope
- Writing spec-compliant `SKILL.md` frontmatter
- Structuring atomic `references/*.md` for an agent to traverse

## Concepts

- [[references/folder-layout]] — `.cursor/skills/<name>/SKILL.md` + `references/`
- [[references/skill-md-frontmatter]] — required and optional fields
- [[references/skill-graph-pattern]] — Map-of-Content + atomic references with `[[wikilinks]]`
- [[references/scopes]] — project, user, plugins
- [[references/sdk-integration]] — loading via `local.settingSources`

## Distribution

- [[references/installing-skill-packs]] — `npx skills add <repo>` and bring-your-own
- [[references/internal-flag]] — `metadata.internal` to hide nodes from listings

## Cross-links

- Project rules — sibling `.cursor/` feature → [[../cursor-rules/SKILL]]
- Hooks — sibling `.cursor/` feature → [[../cursor-hooks/SKILL]]
- This repo *is* a skill pack — see the top-level `README.md` and `AGENTS.md`.

