npx skills install copies the whole repo, not just the skill

Open
#336 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 6 days

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
57/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
json, python, yaml

Research direction

Start by reading the root SKILL.md and AGENTS.md, then trace the skill paths referenced in .claude-plugin/plugin.json, .cursor-plugin/plugin.json, package.json, scripts/validate-package.py, README.md, and the CI workflow. Check how each installer locates the skill and how validation covers packaged files. Done means installs contain only the skill files needed for each agent, and the package checks pass.

Written by the indexing model from the issue text.

Description

npx skills add blader/humanizer copies the whole repo into the agent's skills folder, not just the skill.

The skills CLI copies the folder that holds SKILL.md. Here that folder is the repo root, so the install includes everything except .git.

Steps

mkdir t && cd t
npx skills add blader/humanizer --agent claude-code -y
find .claude/skills/humanizer -type f

Result (4.0.0)

.claude/skills/humanizer/SKILL.md
.claude/skills/humanizer/agents/openai.yaml
.claude/skills/humanizer/README.md
.claude/skills/humanizer/AGENTS.md
.claude/skills/humanizer/CHANGELOG.md
.claude/skills/humanizer/LICENSE
.claude/skills/humanizer/package.json
.claude/skills/humanizer/scripts/validate-package.py
.claude/skills/humanizer/.claude-plugin/plugin.json
.claude/skills/humanizer/.claude-plugin/marketplace.json
.claude/skills/humanizer/.cursor-plugin/plugin.json
.claude/skills/humanizer/.github/workflows/validate.yml
.claude/skills/humanizer/.github/ISSUE_TEMPLATE/*.yml

Only SKILL.md (and agents/openai.yaml for OpenAI-compatible agents) is needed. Most of the rest just takes space. AGENTS.md is a real problem: some agents load that file on their own, so the repo's maintenance rules end up next to the installed skill.

npx skills add . --list passes, so the release check in AGENTS.md does not catch this.

Possible fix

Move the skill into its own folder, for example skills/humanizer/SKILL.md (with agents/openai.yaml beside it), and point each installer there:

  • .claude-plugin/plugin.json: skill path
  • .cursor-plugin/plugin.json: add a skills path
  • package.json: pi.skills
  • scripts/validate-package.py, AGENTS.md, README.md, and the CI workflow, wherever they name the root SKILL.md

This changes the "root SKILL.md is the source of truth" rule in AGENTS.md, so I'm opening an issue before a PR. Happy to send the PR if this direction works for you.

Dominant language
Python
Stars
53.9k
Forks
4.3k
Avg merge
6d 11h
Merged PRs (30d)
9

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from blader/humanizer

All issues in blader/humanizer

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.