Skip to content

Incomplete skill installation via npx skills add (Missing folders/broken links) #11

Description

@dmitrii-esin

Hi there!

When installing this skill using the npx skills add CLI, the links within SKILL.md (e.g., core/fixtures-hooks.md, advanced/authentication.md) are broken because those subdirectories are not downloaded to the user's machine.

Why this happens:
The npx skills add tool is designed to only fetch the SKILL.md file and recognized standard skill subdirectories (specifically references/, resources/, scripts/, and examples/). Custom folders at the root level like core/, advanced/, and testing-patterns/ are ignored by the installer.

Suggested Fix:
To make the skill fully compatible with the AI agent ecosystem and the skills CLI:

  1. Move the core/, advanced/, and testing-patterns/ directories into a standard references/ directory (e.g., references/core/, etc.).
  2. Update the relative links inside SKILL.md to point to the new paths (e.g., [fixtures-hooks.md](references/core/fixtures-hooks.md)).

Thanks for putting this skill together!

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions