// When the same multi-step workflow repeats in Cursor (user corrections or agent redos), capture it as a new SKILL.md under .cursor/skills/ so future sessions load it automatically.
| name | building-skills-from-patterns |
| description | When the same multi-step workflow repeats in Cursor (user corrections or agent redos), capture it as a new SKILL.md under .cursor/skills/ so future sessions load it automatically. |
| user-invocable | true |
Skills are reusable SKILL.md files. This meta-skill tells the agent to promote repeated muscle memory into a named skill: research once, encode the workflow, reuse forever.
suggesting-cursor-rules if it should be always-on; use a skill if it is a procedure with steps.Choose a short slug (lowercase, hyphens): verifying-api-before-merge, releasing-mobile-build, etc.
SKILL.mdCreate .cursor/skills/<slug>/SKILL.md (or in this repo’s pattern, copy from resources/<slug>/SKILL.md when contributing upstream).
Frontmatter:
---
name: <slug>
description: One line: what it does and when to use it. Ends with a clear trigger.
user-invocable: true # optional, if the user should be able to invoke by name
---
Body sections (keep lean):
npm, gh, MCP tools).Match the tone of other skills in the repo: concrete commands, no filler.
Tell the user where the file lives and that the agent will pick it up on the next chat in that workspace.
| Mechanism | Use for |
|---|---|
| Skill | On-demand procedure, branching steps, tool usage. |
Rule (.cursor/rules/) | Always-on conventions, style, file patterns. |
Hook (.cursor/hooks.json) | Automate after file save / stop events. |
If the pattern is “every time I save, run X,” suggest a hook instead. If it is “when I ask to ship,” keep it as a skill.
Generate or edit images using the OpenAI Image API (gpt-image-2). Use when the user asks to generate, create, draw, render, illustrate, mock up, or edit an image, icon, logo, mockup, illustration, OG image, blog hero, marketing asset, or similar visual. Also use when the user supplies a reference image and asks to modify, restyle, or remix it. Triggers on: "generate an image", "create an image", "make a picture of", "edit this image", "restyle this", "make a mockup of", "draw a", "render a", "illustration of".
After navigating and interacting in Cursor's built-in browser, use browser_network_requests to audit every fetch/XHR for failures, slowness, duplicate calls, and suspicious payloads. Use for API-heavy pages and after backend or client networking changes.
When GitHub Actions fails, fetch failing job logs and assign each failing job to a separate subagent that fixes its slice of the problem in parallel. Use for multi-job CI failures where jobs are independent.
Run four parallel read-only subagents that each review the same diff from a different lens — security, performance, correctness, and readability — then merge findings into one report. Use before merging large or risky PRs.
Execute a user flow step-by-step in Cursor's built-in browser while documenting each action, then emit a Playwright test that replays the same flow using stable selectors derived from the accessibility tree.
Automatically persist useful context — research, decisions, learnings, templates — to workspace files so knowledge survives across conversations.