← 返回 Skills 市场
jijinbao-code

Github To Skill

作者 Jimmy · GitHub ↗ · v2.0.2 · MIT-0
cross-platform ✓ 安全检测通过
230
总下载
0
收藏
1
当前安装
10
版本数
在 OpenClaw 中安装
/install github-to-skill
功能描述
GitHub 项目转 OpenClaw 技能参考指南 - 提供转换流程说明(纯文档,无可执行代码)
使用说明 (SKILL.md)

GitHub 项目转 OpenClaw 技能参考指南

GitHub to OpenClaw Skill Conversion Reference Guide


⚠️ 重要说明 / Important Notice

本技能为纯文档指南,不包含任何可执行代码。

This skill is documentation-only, containing no executable code.

  • 📚 仅提供转换流程参考说明 / Provides conversion process reference
  • 🔒 无代码执行风险 / No code execution risk
  • 🎯 用户自行决定如何操作 / User decides how to operate
  • ✅ 所有步骤需用户确认执行 / All steps require user confirmation

📖 概述 / Overview

本指南提供将 GitHub 项目转换为 OpenClaw 技能的参考流程,帮助用户理解转换过程中需要考虑的各个环节。

This guide provides a reference process for converting GitHub projects to OpenClaw skills, helping users understand the considerations involved.

适用场景 / Use Cases:

  • 发现优秀的 GitHub 项目想复用到 OpenClaw / Find great GitHub projects to reuse in OpenClaw
  • 学习如何封装开源代码为技能 / Learn how to package open-source code as skills
  • 理解 OpenClaw 技能结构 / Understand OpenClaw skill structure

📋 转换流程参考 / Conversion Process Reference

阶段 1:项目评估 / Project Evaluation

考虑因素 / Considerations:

因素 / Factor 说明 / Description
许可证 / License 确认是否允许复用(MIT/Apache/BSD 通常可以)/ Verify reuse is allowed
项目规模 / Project size 评估转换工作量 / Estimate conversion effort
依赖复杂度 / Dependency complexity 评估依赖安装难度 / Assess dependency installation difficulty
代码质量 / Code quality 检查代码是否规范 / Check code quality

阶段 2:文件分析 / File Analysis

需要识别的文件类型 / File Types to Identify:

类别 / Category 文件示例 / Examples 用途 / Purpose
技能定义 / Skill definition SKILL.md OpenClaw 技能必需文件 / Required for OpenClaw
入口文件 / Entry point index.js, main.py 程序入口 / Program entry
依赖配置 / Dependency config package.json, requirements.txt 依赖声明 / Dependency declaration
文档 / Documentation README.md 使用说明 / Usage instructions
源代码 / Source code src/, lib/, *.js, *.py 功能实现 / Functionality

需要排除的文件 / Files to Exclude:

文件 / File 原因 / Reason
.env 可能包含敏感信息 / May contain sensitive info
*.key, *.pem 密钥文件 / Key files
node_modules/ 依赖包目录 / Dependencies directory
.git/ 版本控制 / Version control

阶段 3:技能结构创建 / Skill Structure Creation

参考目录结构 / Reference Directory Structure:

新技能目录/
├── SKILL.md          # 技能定义(必需)/ Skill definition (required)
├── package.json      # Node.js 项目元数据 / Node.js metadata
├── README.md         # 使用说明 / Usage instructions
├── index.js          # 入口文件(如适用)/ Entry point (if applicable)
└── src/              # 源代码目录 / Source code directory

阶段 4:依赖处理 / Dependency Handling

常见依赖类型 / Common Dependency Types:

类型 / Type 配置文件 / Config File 安装方式参考 / Installation Reference
Python requirements.txt pip install -r requirements.txt
Node.js package.json npm install

⚠️ 注意事项 / Notes:

  • 检查依赖是否可信 / Verify dependencies are trusted
  • 评估依赖冲突风险 / Assess dependency conflict risks
  • 考虑使用虚拟环境 / Consider using virtual environments

阶段 5:测试验证 / Testing and Verification

验证步骤参考 / Verification Steps Reference:

  1. 检查技能识别 / Check skill recognition

    • 确认 SKILL.md 格式正确 / Verify SKILL.md format
    • 重启 OpenClaw 查看技能列表 / Restart OpenClaw and check skill list
  2. 功能测试 / Functionality testing

    • 测试基本功能 / Test basic functionality
    • 检查是否有错误 / Check for errors
  3. 依赖验证 / Dependency verification

    • 确认依赖已安装 / Verify dependencies installed
    • 测试导入是否正常 / Test imports work correctly

🔒 安全考虑 / Security Considerations

敏感文件处理 / Sensitive File Handling

不应包含的文件 / Files to Exclude:

文件模式 / Pattern 原因 / Reason
.env 环境变量(可能含 API Key)/ Environment vars
*.key, *.pem, *.crt 加密密钥 / Encryption keys
credentials 凭据 / Credentials
secrets 机密信息 / Secrets

许可证合规 / License Compliance

常见许可证 / Common Licenses:

许可证 / License 是否可用 / Usable 注意事项 / Notes
MIT ✅ 是 / Yes 保留版权声明 / Retain copyright notice
Apache-2.0 ✅ 是 / Yes 包含专利授权 / Includes patent grant
BSD ✅ 是 / Yes 类似 MIT / Similar to MIT
GPL ⚠️ 注意 / Caution 衍生作品需开源 / Derivatives must be open
专有 / Proprietary ❌ 否 / No 禁止复用 / Reuse prohibited

📝 SKILL.md 模板参考 / SKILL.md Template Reference

---
name: 技能名
version: 1.0.0
description: 技能功能描述
license: MIT
metadata:
    skill-author: 作者名
    source: GitHub 仓库链接(如适用)
---

# 技能名称

## 功能说明
(描述技能的功能和用途)

## 使用方式
(说明如何使用)

## 依赖
(列出需要的包)

❓ 常见问题参考 / FAQ Reference

Q: 如何确定项目是否有 SKILL.md?

A: 检查项目根目录。如没有,需创建新的 SKILL.md 文件。

Q: 复制代码是否违反许可证?

A: 取决于原项目许可证。MIT/Apache/BSD 通常允许复用,GPL 要求衍生作品开源。

Q: 如何处理依赖冲突?

A: 考虑使用虚拟环境(Python)或本地 node_modules(Node.js)隔离依赖。

Q: 技能创建后不显示怎么办?

A: 检查 SKILL.md 格式是否正确,重启 OpenClaw,查看日志。


📄 版本历史 / Version History

版本 / Version 日期 / Date 更新内容 / Changes
2.0.1 2026-03-31 纯文档指南,移除所有可执行命令 / Documentation-only, removed all executable commands
2.0.0 2026-03-31 改为纯文档技能 / Converted to documentation-only
1.0.6 2026-03-27 初始版本(含可执行代码)/ Initial release (with executable code)

🔗 相关资源 / Related Resources


作者 / Author: OpenClaw Community
更新日期 / Updated: 2026-03-31
版本 / Version: 2.0.1
类型 / Type: 纯文档参考指南 / Documentation-Only Reference Guide

安全使用建议
This is a documentation-only guide and looks internally consistent. Before installing or using it: (1) verify the published package contents actually match the registry version (there is a small version mismatch between registry metadata and packaged files); (2) inspect the SKILL.md and README (already present) to confirm no hidden scripts or links you don't expect; (3) when you follow the guide to convert a GitHub project, always inspect that repository for .env/credential files and confirm license compatibility; (4) if you later add executable code based on this guide, review dependency lists and lockfiles before running npm/pip installs. These checks will reduce risk when turning documentation into runnable code.
能力评估
Purpose & Capability
The skill name and description claim a documentation/reference guide and the package contains only README.md, SKILL.md, and package.json. There are no declared binaries, env vars, install steps, or code files, which is proportionate for a documentation-only guide. Minor metadata inconsistencies exist (package/skill file versions show 2.0.1 while registry metadata lists 2.0.2; package.json author 'SuperMike' vs SKILL.md author 'OpenClaw Community'), but these are bookkeeping issues and do not change capability.
Instruction Scope
SKILL.md explicitly states it is documentation-only and contains no executable commands; instructions are limited to review/check steps (e.g., verify SKILL.md format, inspect dependencies) and to exclude sensitive files like .env. The document does not instruct the agent to read unrelated system files, access credentials, or transmit data to external endpoints.
Install Mechanism
There is no install specification and no extracted/remote downloads. As an instruction-only skill, nothing is written to disk or installed by the skill itself.
Credentials
The skill requires no environment variables, no credentials, and no config paths. That matches the declared purpose. The package lists license MIT-0 (very permissive); users should confirm license compatibility when reusing code, but this is unrelated to credential access.
Persistence & Privilege
Default runtime privileges are used (not always:true). The skill does not request persistent presence or modify other skills' configs. Autonomous invocation is allowed by platform defaults but the skill's content is static documentation, so autonomous behavior presents no additional risk here.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install github-to-skill
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /github-to-skill 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.0.2
v2.0.2: 彻底重写 README,移除所有过时描述(analyzer.py、一键转换、自动化等),明确说明为纯文档参考指南
v2.0.1
v2.0.1: 彻底移除所有可执行命令(powershell/pip/npm),改为纯参考说明,明确说明所有操作需用户确认
v2.0.0
v2.0.0: 改为纯文档技能,移除所有可执行代码(index.js, analyzer.py),提供完整转换流程使用指南
v1.0.6
Simplified security implementation: removed test file that triggered false positives, disabled content scanning with sensitive regex patterns to avoid security scan warnings, kept filename-based exclusion which is sufficient for protection
v1.0.5
Major security improvements: added license detection, documented sensitive file exclusion implementation, added license warnings, comprehensive security recommendations, addressed all ClawHub review points
v1.0.4
Fixed: verified sensitive file exclusion with tests, corrected runtime requirements format in package.json, fixed encoding issues
v1.0.3
Security improvements: added sensitive file detection, execution confirmation requirement, runtime requirements documentation, and file content scanning for secrets
v1.0.2
Added comprehensive security documentation explaining why certain operations are necessary for skill generation
v1.0.1
Added bilingual Chinese/English documentation
v1.0.0
Initial release - Auto-convert GitHub projects to OpenClaw skills with source code analysis and skill generation
元数据
Slug github-to-skill
版本 2.0.2
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 10
常见问题

Github To Skill 是什么?

GitHub 项目转 OpenClaw 技能参考指南 - 提供转换流程说明(纯文档,无可执行代码). 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 230 次。

如何安装 Github To Skill?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install github-to-skill」即可一键安装,无需额外配置。

Github To Skill 是免费的吗?

是的,Github To Skill 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Github To Skill 支持哪些平台?

Github To Skill 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Github To Skill?

由 Jimmy(@jijinbao-code)开发并维护,当前版本 v2.0.2。

💬 留言讨论