Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Support installing complete skill directories with arbitrary nested resources

Aperta
  • Qualcosa non va?
#21 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
node.js, typescript
Ambito
cli, tooling

Direzione di ricerca

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.

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

Descrizione

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.

Lingua principale
TypeScript
Stelle
186
Fork
40
Merge medio
10h 12m
PR unite (30g)
16

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

Tutte le issue di nextlevelbuilder/skillx

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.