Troubleshooting

Most problems come down to a folder in the wrong place or an assistant opened in the wrong folder. Start here.

Downloads

The thanks page says it is still confirming my payment. Wait a minute and refresh. Payment confirmation can take a moment. The same download link is in your receipt email.

My account says "No paid packs on this email yet". Sign out and sign in with the email you used at checkout. Purchases are matched to that email.

I lost the download. Sign in at /account and download it again. Updates are free.

Installing

My assistant doesn't recognize the pack.

1. Check the path. It should be, for example, ~/.claude/skills/step1-pack/SKILL.md. Unzipping sometimes adds an extra folder level (step1-pack/step1-pack/SKILL.md); move the inner folder up one level.
2. Make sure you copied the whole folder, not just SKILL.md.
3. Restart your assistant.
4. Codex: older versions read ~/.codex/skills/ instead of ~/.agents/skills/.

I can't find the .claude or .cursor folder. Folders that start with a dot are hidden. On a Mac, press Cmd + Shift + . in Finder to show them, or use the Terminal commands in each install guide.

Cursor lists lots of sub-skills. That's expected. They all route back through the pack's root SKILL.md.

The coach forgot me

It ran the setup interview again. Your assistant was probably opened in a different folder, so it couldn't find skillplug-state/. Open it in the same study folder every time. If you moved the folder, tell the coach where it is.

I'm using ChatGPT, Claude.ai, or Gemini. Chat apps can't save files between chats. Paste your latest STATE block at the start of each new chat. See Chat assistants.

Something in my state looks wrong. Say "my state looks broken". The coach runs repair mode: it lists what doesn't add up, proposes fixes, and asks before writing.

Sync

The coach says my key was rejected (sync is paused). The key was revoked or mistyped. Create a new key on the AI connections page and say "Connect my SkillPlug account. My key is ready." Sync turns back on once the new key works.

My dashboard is empty. Every panel shows from day one and fills in once your AI syncs. If panels stay empty, make sure your AI is connected on Connect your AI. Check that sync is on (and not paused on the AI connections page) and say "sync my dashboard". A brand-new pack has only a little data at first.

Too many syncs. Accounts allow 30 syncs per rolling hour. The coach skips the sync and tries again next session.

I see "Coming soon" for Residency. The residency dashboard isn't available yet. Away Rotations syncs today.

Planner

My plan disappeared. The online planner saves in the browser you used. A different browser, a private window, or clearing site data won't have it. Use More, then Export a backup regularly, and Import a plan to restore.

My AI's changes don't show up. Ask your AI to update your dashboard, then reopen dashboard.html, or import the plan JSON at /planner. The newer copy (by updatedAt) wins.

Still stuck?

Email support@skillplug.io with your pack, your assistant, and what you see. Refunds are available within 14 days of purchase.