Skills link to ../../tools/* files that the recommended npx install does not copy (dead links in ai-seo, churn-prevention, emails)

Author: Namine4Created Aug 23, 2026Updated Aug 23, 2026

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

bash
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:

  1. 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).
  2. Replace the relative links with absolute GitHub URLs to the tools/ files, so they at least resolve from an installed copy.
  3. 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.

Source: coreyhaines31/marketingskills