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

Aperta
#336 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 6 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
57/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
json, python, yaml

Direzione di ricerca

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.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
Python
Stelle
53.9k
Fork
4.3k
Merge medio
6g 11h
PR unite (30g)
9

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di blader/humanizer

Tutte le issue di blader/humanizer

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.