Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Support installing complete skill directories with arbitrary nested resources

Đang mở
  • Có gì không ổn?
#21 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
node.js, typescript
Lĩnh vực
cli, tooling

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
TypeScript
Star
186
Fork
40
Merge trung bình
10 giờ 12 phút
Pull request đã merge (30 ngày)
16

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của nextlevelbuilder/skillx

Tất cả issue của nextlevelbuilder/skillx

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.