mcpField
G
github-to-skills

github-to-skills

github.com/kkkkhazixAgent 工作流21.7k260 次安装4 周前更新
代码仓库

关于 github-to-skills

github-to-skills 是面向 Agent 工作流的技能，可将 GitHub 仓库整理为包含说明文件和包装脚本的 AI 技能，并记录来源及版本信息。

主要功能

  1. 01获取仓库说明、README 和提交哈希
  2. 02生成标准技能目录结构
  3. 03写入含来源与版本的 SKILL.md
  4. 04创建工具调用包装脚本
  5. 05校验提交哈希记录

适用场景

  1. 01将 GitHub 仓库打包为可复用技能
  2. 02为技能生成来源与版本追踪信息
  3. 03为仓库工具创建调用包装脚本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kkkkhazix/khazix-skills --skill github-to-skills

安装后在 Claude Code 中输入/github-to-skills确认已加载。

附带文件scripts/create_github_skill.pyscripts/fetch_github_info.py

详细介绍

GitHub to Skills 工厂

此技能可将 GitHub 仓库自动转换为功能完备的 AI 技能。

核心功能

  1. 分析：获取仓库元数据（描述、README、最新提交哈希）。
  2. 搭建骨架：创建标准化的技能目录结构。
  3. 注入元数据：生成带有扩展 frontmatter 的 SKILL.md（记录来源、版本、哈希），以便日后自动管理。
  4. 生成封装脚本：创建 scripts/wrapper.py（或类似文件），用于与工具交互。

用法

触发方式：/GitHub-to-skills <github_url> 或“将此仓库打包成技能：”

必需的元数据架构

此工厂创建的每个技能都必须在其 SKILL.md 中包含以下扩展 YAML frontmatter。这对 skill-manager 日后正常运行至关重要。

---
name: <kebab-case-repo-name>
description: <concise-description-for-agent-triggering>
# EXTENDED METADATA (MANDATORY)
github_url: <original-repo-url>
github_hash: <latest-commit-hash-at-time-of-creation>
version: <tag-or-0.1.0>
created_at: <ISO-8601-date>
entry_point: scripts/wrapper.py # or main script
dependencies: # List main dependencies if known, e.g., ["yt-dlp", "ffmpeg"]
---

工作流

  1. 获取信息：Agent 首先运行 scripts/fetch_github_info.py，从仓库中获取原始数据。
  2. 规划：Agent 分析 README，了解如何调用工具（CLI 参数、Python API 等）。
  3. 生成：Agent 使用 skill-creator 模式编写 SKILL.md 和封装脚本，确保包含扩展元数据。
  4. 验证：检查是否正确获取了提交哈希。

资源

  • scripts/fetch_github_info.py：用于抓取或通过 API 获取仓库详情的工具（README、哈希、标签）。
  • scripts/create_github_skill.py：用于搭建目录骨架并编写初始文件的编排器。

生成技能的最佳实践

  • 隔离性：生成的技能应尽可能自行安装依赖项（例如，在 venv 中或通过 uv/pip 安装），否则应明确说明依赖项。
  • 渐进式披露：不要将整个仓库都放进技能中。只包含必要的封装代码，并在需要深入了解时引用原始仓库。
  • 幂等性：github_hash 字段可让未来的 skill-manager 检查 if remote_hash != local_hash，以触发更新。

评论

支持 Markdown