How to Set Up Promptzy Sync with Claude, Cursor, and Other AI Apps

Promptzy syncs your prompts and skills to AI apps like Claude and Cursor by writing Markdown files into each app's skills folder. This guide walks you through connecting your first app, finding the hidden skills folder, and adding more connectors later.

The whole process takes about two minutes.

What Happens When You Sync

When you connect an AI app to Promptzy, two things happen:

1. Push: Every prompt in your Promptzy vault gets written as a Markdown file into the app's skills folder. Claude and Cursor read these files automatically.
2. Watch: Promptzy monitors the skills folder for changes. If you edit a skill directly inside Claude or Cursor, Promptzy detects the change and pulls it back into your vault.

This is bidirectional. Edit in Promptzy, it appears in Claude. Edit in Claude, it appears in Promptzy. If both sides change the same skill, Promptzy flags the conflict and lets you pick which version to keep.

Option 1: Set Up During Onboarding

When you first open Promptzy, the onboarding flow includes a sync step. Here's what to do:

Step 1: Choose Your Vault Location

Promptzy asks where to store your prompt library. Pick any folder you like. This is your local vault — the single source of truth for all your skills.

Step 2: Add an AI App

On the sync setup screen, you'll see a field for the app name and a folder picker.

For Claude, enter:

• App name: Claude
• Folder path: ~/.claude/skills

For Cursor, enter:

• App name: Cursor
• Folder path: ~/.cursor/skills

These folders are hidden by default on macOS. When the folder picker opens, press Cmd + Shift + . (period) to reveal hidden files and folders. Then navigate to your home directory, find .claude or .cursor, and select the skills folder inside it.

If the skills folder doesn't exist yet, create it:

• For Claude: create a skills folder inside ~/.claude/
• For Cursor: create a skills folder inside ~/.cursor/

Step 3: Confirm the Initial Sync

Promptzy shows a preview of what will happen: how many skills will push from your vault to the app, how many existing skills in the target folder will import into your vault, and whether any conflicts exist. Review and confirm.

That's it. Sync is active.

Option 2: Add App Connectors in Settings

If you skipped sync during onboarding, or you want to add more apps later, go to Settings.

1. Open Promptzy and click the gear icon or press Cmd + , to open Settings.
2. Scroll to the Sync Folders section.
3. Click Add Sync Target.
4. Enter the app name (e.g., "Claude") and browse to its skills folder path.
5. Toggle the sync on.

Promptzy will show a sync preview before enabling. You'll see which skills will push, which will import, and any conflicts. Confirm to start syncing.

Free vs. Pro

• Free plan: 1 app connector.
• Pro plan: Up to 10 app connectors.

Where Each App Stores Skills

The trickiest part of setup is finding the right folder. Here's a quick reference:

Revealing Hidden Folders on macOS

Both .claude and .cursor are dot-folders, which macOS hides by default. To find them:

1. Open Finder and press Cmd + Shift + G to open "Go to Folder."
2. Type ~/.claude/skills (or ~/.cursor/skills) and press Enter.
3. If the skills folder doesn't exist, navigate to ~/.claude first, then create a new folder named skills.

Alternatively, in any Finder window or file picker dialog, press Cmd + Shift + . to toggle hidden file visibility.

What Gets Synced

Each prompt in your Promptzy vault becomes a Markdown file in the target app's skills folder. The file structure looks like this:

~/.claude/skills/
├── code-review/
│   └── SKILL.md
├── error-handling/
│   └── SKILL.md
└── documentation-style/
    └── SKILL.md

Each SKILL.md file contains the skill name, a short description, and the full prompt body. Claude and Cursor read these automatically — no additional configuration needed inside those apps.

If you organize prompts into collections in Promptzy, those collections become nested folders:

~/.claude/skills/
├── coding-standards/
│   ├── typescript-guidelines/
│   │   └── SKILL.md
│   └── react-patterns/
│       └── SKILL.md
└── review-checklists/
    ├── security-review/
    │   └── SKILL.md
    └── performance-review/
        └── SKILL.md

After Setup: Day-to-Day Workflow

Once sync is active, you don't need to think about it. Here's what happens automatically:

• Add a prompt in Promptzy → it appears in Claude and Cursor within seconds.
• Edit a skill in Claude → Promptzy detects the change and updates your vault.
• Delete a prompt in Promptzy → the corresponding file is removed from synced apps.
• Conflict detected → Promptzy shows both versions side-by-side in the Sync panel. Pick the one you want to keep.

You can also click Sync Now in the Sync panel to force an immediate sync, or temporarily disable sync for a specific app without removing the connector.

Troubleshooting

Skills aren't appearing in Claude or Cursor

• Verify the folder path is correct. Open a terminal and run ls ~/.claude/skills to confirm files are there.
• Make sure the sync target is enabled (green dot in Settings).
• Restart the AI app. Claude and Cursor may need a refresh to pick up new skills files.

"Folder not found" error

• The skills folder may not exist yet. Create it manually: open Terminal and run mkdir -p ~/.claude/skills or mkdir -p ~/.cursor/skills.

Conflicts keep appearing

• This means the same skill was edited in both Promptzy and the target app. Open the Sync panel, review both versions, and choose which to keep. Once resolved, Promptzy overwrites the other version.

Can't see hidden folders in the file picker

• Press Cmd + Shift + . in the file picker dialog to toggle hidden file visibility.

Summary

1. Connect an AI app by entering its name and skills folder path — either during onboarding or in Settings.
2. For Claude, the path is ~/.claude/skills. For Cursor, it's ~/.cursor/skills. Press Cmd + Shift + . to reveal them.
3. Promptzy handles everything from there: pushing, importing, watching for changes, and flagging conflicts.

Once connected, your prompts live in one place and work everywhere.