Summary
Several skills link to files outside their own folder (../../tools/REGISTRY.md and ../../tools/integrations/*.md). Those links resolve inside this repository, but the recommended install path (npx skills add coreyhaines31/marketingskills, README "Option 1") copies only the individual skills/<name>/ folders into .claude/skills/. After install, every one of these links is dead, and an agent that follows the skill's instruction to "see the tools registry" gets a missing file.
Affected links (as of v2.x on main)
| File |
Line |
Target |
| skills/ai-seo/SKILL.md |
463 |
../../tools/REGISTRY.md |
| skills/churn-prevention/SKILL.md |
363 |
../../tools/integrations/posthog.md |
| skills/churn-prevention/SKILL.md |
384 |
../../tools/REGISTRY.md |
| skills/emails/SKILL.md |
290 |
../../tools/REGISTRY.md |
| skills/emails/SKILL.md |
294 |
../../tools/integrations/customer-io.md |
| skills/emails/SKILL.md |
295 |
../../tools/integrations/mailchimp.md |
| skills/emails/SKILL.md |
296 |
../../tools/integrations/nitrosend.md |
| skills/emails/SKILL.md |
297 |
../../tools/integrations/resend.md |
| skills/emails/SKILL.md |
298 |
../../tools/integrations/sendgrid.md |
| skills/emails/SKILL.md |
299 |
../../tools/integrations/kit.md |
Line numbers are from copies installed on 2026-08-16; they may have shifted slightly with later commits, but the targets are the same.
Reproduce
npx skills add coreyhaines31/marketingskills --skill emails -a claude-code
ls .claude/skills/emails/../../tools # does not exist
Suggested fixes
Any of these would work:
- Make each skill self-contained by copying the handful of integration notes it needs into its own
references/ folder (the Agent Skills guidance expects a skill folder to be portable on its own).
- Replace the relative links with absolute GitHub URLs to the
tools/ files, so they at least resolve from an installed copy.
- If the registry is meant to be plugin-only, note in each skill that the links require the plugin install (Option 2), and drop them from the CLI-installed output.
The plugin install path (Option 2) is unaffected since the plugin root includes tools/.
Thanks for maintaining these, the v2 updates were a clear improvement.
Summary
Several skills link to files outside their own folder (
../../tools/REGISTRY.mdand../../tools/integrations/*.md). Those links resolve inside this repository, but the recommended install path (npx skills add coreyhaines31/marketingskills, README "Option 1") copies only the individualskills/<name>/folders into.claude/skills/. After install, every one of these links is dead, and an agent that follows the skill's instruction to "see the tools registry" gets a missing file.Affected links (as of v2.x on main)
Line numbers are from copies installed on 2026-08-16; they may have shifted slightly with later commits, but the targets are the same.
Reproduce
Suggested fixes
Any of these would work:
references/folder (the Agent Skills guidance expects a skill folder to be portable on its own).tools/files, so they at least resolve from an installed copy.The plugin install path (Option 2) is unaffected since the plugin root includes
tools/.Thanks for maintaining these, the v2 updates were a clear improvement.