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

Abierto
#336 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 6 días

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
57/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
json, python, yaml

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
Python
Estrellas
53.9k
Forks
4.3k
Merge medio
6 d 11 h
PR fusionados (30 d)
9

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de blader/humanizer

Todos los issues de blader/humanizer

Issues similares

Más issues de Python

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.