npx skills install copies the whole repo, not just the skill
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
- Domain
- developer-experience, tooling
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 askillspathpackage.json:pi.skillsscripts/validate-package.py,AGENTS.md,README.md, and the CI workflow, wherever they name the rootSKILL.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
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from blader/humanizer
-
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
Maintainers usually reply within 6 days
-
validate-package.py: duplicated pattern section in SKILL.md passes validation (dict key collapse defeats the numbering check)Possibly taken @TanmayShah29 claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 25/100
Maintainers usually reply within 6 days
All issues in blader/humanizer
Similar issues
-
automated endpoint-dead needs-curation
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
almanac-data/climate-almanac#138 ·
Maintainers usually reply within 1 day
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
OceanDataTools/openrvdas#760 ·
Maintainers usually reply within 1 day
-
level/subtask type/enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
wazuh/wazuh-virtual-machines#1091 ·
Maintainers usually reply within 1 day
-
Python: Bug: ChatMessageContent.from_element drops AudioContent and BinaryContent into raw TextContentPossibly taken @halcyon-past claimed this today. Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
microsoft/semantic-kernel#14824 · 1 comment ·
Maintainers usually reply within 3 days
-
help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
stack314/django-neolith#142 · 1 comment ·
Maintainers usually reply within 1 day