Skip to content

fix: update Cursor install instructions to use native skills directory#32

Open
gonzoblasco wants to merge 2 commits into
Nutlope:mainfrom
gonzoblasco:fix/cursor-install-instructions
Open

fix: update Cursor install instructions to use native skills directory#32
gonzoblasco wants to merge 2 commits into
Nutlope:mainfrom
gonzoblasco:fix/cursor-install-instructions

Conversation

@gonzoblasco

Copy link
Copy Markdown

Summary

Fixes #22 — the Cursor install instructions were misleading and sub-optimal.

Problem

The README told users to copy the body of SKILL.md into .cursor/rules/hallmark.mdc, which:

  1. Strips the YAML frontmatter — Cursor supports the Agent Skills standard and requires frontmatter for skill discovery
  2. Ignores reference files — Hallmark depends on references/ for anti-patterns, macrostructures, typography, etc. A single .mdc file cannot include them
  3. Uses the wrong format.mdc is for Cursor Rules (simple instructions), not for multi-file skills with references

Fix

  • Changed Cursor path from .cursor/rules/hallmark.mdc to .cursor/skills/hallmark/ (project-scoped) or ~/.cursor/skills/hallmark/ (global)
  • Added a note explaining that Cursor supports the same Agent Skills standard as Claude Code, and that the full folder (with references) should be kept intact
  • Updated the copy instruction to reference the full skills/hallmark/ folder instead of individual files

Verification

Cursor docs confirm that .cursor/skills/ supports the same folder structure as Claude Code: a directory with SKILL.md + optional references/, scripts/, and assets/ subdirectories.

The previous instructions told users to copy the SKILL.md body into
.cursor/rules/hallmark.mdc, which:
- Strips the YAML frontmatter that Cursor's Agent Skills standard requires
- Ignores the reference/ files that Hallmark depends on
- Uses the .mdc rules format instead of the native skills directory

Cursor supports the same Agent Skills standard as Claude Code. The correct
install path is .cursor/skills/hallmark/ (project-scoped) or
~/.cursor/skills/hallmark/ (global), keeping the full folder structure.

Closes Nutlope#22
@vercel

vercel Bot commented Jul 16, 2026

Copy link
Copy Markdown

@gonzoblasco is attempting to deploy a commit to the Together AI Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Misleading/sub-optimal install instructions for Cursor

1 participant