Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Support installing complete skill directories with arbitrary nested resources

Abierto
  • ¿Algo no está bien?
#21 3 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
node.js, typescript
Área
cli, tooling

Línea de trabajo

Start by reading the registration flow, resource enrichment, and skillx use implementation to understand what data is stored and how the CLI currently renders it. Then trace how a selected skill directory could be represented and installed as a complete tree. Done means an install path preserves arbitrary nested files and relative paths, verifies the installed tree against a manifest, and rejects the unsafe inputs listed in the issue.

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

Descripción

enhancement

Problem

SkillX can discover and publish nested SKILL.md files and now exposes references/ and scripts/ metadata, but the current consumer command does not install a skill directory. skillx use prints the stored SKILL.md content and optional reference/script metadata to stdout.

Production skills often require arbitrary nested resources beyond those two folders: modules/, assets/, browser adapters, configuration files, templates, tests, and package metadata. Registering such a skill succeeds at the metadata layer, but using it cannot reproduce the runnable source tree.

Public reproduction

Source skill:

https://github.com/ASI2030/Fact-Check-X/tree/main/skills/fact-check-x-complete

The skill has 94 files. Its entry point depends on nested modules and browser runtime assets. The current path:

npx skillx-sh use ASI2030/Fact-Check-X/fact-check-x-complete --raw --include-refs --include-scripts

can expose the instruction content plus reference/script metadata, but cannot deliver the required modules/ and other nested files. The command is therefore useful for discovery and inspection, but it is not a complete installation path for this class of skill.

This follows directly from the current implementation:

  • registration fetches the subfolder SKILL.md as the stored skill content;
  • resource enrichment only recognizes references/**/*.md and scripts/**;
  • skillx use renders content and metadata to stdout and does not write a directory tree.

Expected capability

  1. Publish an immutable source commit and a complete file manifest for the selected skill directory.
  2. Add a true install command that writes the complete tree while preserving relative paths and safe file modes.
  3. Support arbitrary nested resources, not only references/ and scripts/.
  4. Verify the installed file count and hashes against the manifest.
  5. Distinguish “view/use content” from “install runtime” in the CLI and marketplace UI.
  6. Reject path traversal, unsafe symlinks, oversized files, secrets, and unsupported executable modes during packaging/install.

A source-backed archive or commit-pinned Git tree would both work. Until a complete-tree install exists, multi-file skills should be labelled as discovery-only when their runtime cannot be reproduced.

Lenguaje dominante
TypeScript
Estrellas
186
Forks
40
Merge medio
10 h 12 min
PR fusionados (30 d)
16

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 nextlevelbuilder/skillx

Todos los issues de nextlevelbuilder/skillx

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.