Skip to content

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

Description

@Namine4

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:

  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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions