Troubleshooting
The seven things pilot users have hit so far, with the fix.
| Symptom | Likely cause | Fix |
|---|---|---|
Marketplace source is blocked by enterprise policy | You ran /plugin marketplace add <path> — blocked by strictKnownMarketplaces. | Use claude --plugin-dir <path> at launch instead. See Install. |
| SSO session expired partway through | magellan SSO tokens are short-lived. | aws login --profile magellan to refresh. |
git clone codecommit::... fails with auth error | git-remote-codecommit not installed, or AWS creds not loaded. | pip install git-remote-codecommit; re-run aws login --profile magellan. |
/plugins list shows the plugin but skills don’t appear in the picker | Frontmatter parse error in a SKILL.md. | claude plugin validate ~/acn-claude-toolkit/plugins/<name> to surface the parse error. |
--add-dir didn’t load my plugins | --add-dir is for filesystem access, not plugins. | Use --plugin-dir (see Install). |
/plugin list returns (no content) | Cosmetic — inline plugins don’t surface in the singular-form CLI list. | Use /plugins list (plural, UI). |
PPTX decryption fails (exit code 3) in acn-slide-gen | DRM-protected file. | Open the file in PowerPoint, “Save As” a fresh copy, use the unprotected version. |
If you hit something not on this list, message Felix directly on Teams or Slack. V1 is a pilot and the symptom catalog grows from feedback.