Create Cursor Agent Skills. Use when authoring a new skill or asking about SKILL.md structure.
This skill guides you through creating effective Agent Skills for Cursor. Skills are markdown files that teach the agent how to perform specific tasks: reviewing PRs using team standards, generating commit messages in a preferred format, querying database schemas, or any specialized workflow.
Clear, step-by-step guidance for the agent.
This SKILL.md is the routing layer. Detailed recipes, examples, integration notes, and troubleshooting guidance live in references/details.md so they are loaded only when the task needs them.
Before producing concrete output, making a design recommendation, or debugging an implementation, load the relevant reference section below. Do not rely on memory for branch-specific APIs, examples, or caveats.
| Task branch | Read first |
|---|---|
| Before You Begin: Gather Requirements | references/details.md#before-you-begin-gather-requirements |
| Skill File Structure | references/details.md#skill-file-structure |
| Examples | references/details.md#examples |
| Writing Effective Descriptions | references/details.md#writing-effective-descriptions |
| Core Authoring Principles | references/details.md#core-authoring-principles |
| Extract PDF text | references/details.md#extract-pdf-text |
| Extract PDF text | references/details.md#extract-pdf-text |
| Quick start | references/details.md#quick-start |
| Additional resources | references/details.md#additional-resources |
| Common Patterns | references/details.md#common-patterns |
| Report structure | references/details.md#report-structure |
| Executive summary | references/details.md#executive-summary |
| Key findings | references/details.md#key-findings |
| Recommendations | references/details.md#recommendations |
| Commit message format | references/details.md#commit-message-format |
| Form filling workflow | references/details.md#form-filling-workflow |
| Document modification workflow | references/details.md#document-modification-workflow |
| Document editing process | references/details.md#document-editing-process |
| Utility Scripts | references/details.md#utility-scripts |
| Utility scripts | references/details.md#utility-scripts |
| Anti-Patterns to Avoid | references/details.md#anti-patterns-to-avoid |
| Current method | references/details.md#current-method |
| Old patterns (deprecated) | references/details.md#old-patterns-deprecated |
| Skill Creation Workflow | references/details.md#skill-creation-workflow |
| Complete Example | references/details.md#complete-example |
| Quick Start | references/details.md#quick-start |
| Review Checklist | references/details.md#review-checklist |
| Providing Feedback | references/details.md#providing-feedback |
| Additional Resources | references/details.md#additional-resources |
| Summary Checklist | references/details.md#summary-checklist |