AgentSkillsCN

github-to-skills

自动化工厂，可将 GitHub 仓库一键转化为专业化的 AI 技能。当用户输入 GitHub 仓库 URL，并希望对其“封装”“包装”或“创建技能”时，可调用此技能。它会自动抓取仓库详情与最新提交哈希，并生成标准化的技能结构，同时补充完善的元数据，便于后续的全生命周期管理。

SKILL.md
--- frontmatter
name: github-to-skills
description: Automated factory for converting GitHub repositories into specialized AI skills. Use this skill when the user provides a GitHub URL and wants to "package", "wrap", or "create a skill" from it. It automatically fetches repository details, latest commit hashes, and generates a standardized skill structure with enhanced metadata suitable for lifecycle management.
category: skill-management
tags:
  - github
  - automation
  - skill-creation
  - lifecycle
license: MIT

GitHub to Skills Factory

This skill automates the conversion of GitHub repositories into fully functional AI skills.

Core Functionality

  1. •Analysis: Fetches repository metadata (Description, README, Latest Commit Hash).
  2. •Scaffolding: Creates a standardized skill directory structure.
  3. •Metadata Injection: Generates SKILL.md with extended frontmatter (tracking source, version, hash) for future automated management.
  4. •Wrapper Generation: Creates a scripts/wrapper.py (or similar) to interface with the tool.

Usage

Trigger: /GitHub-to-skills <github_url> or "Package this repo into a skill: <url>"

Required Metadata Schema

Every skill created by this factory MUST include the following extended YAML frontmatter in its SKILL.md. This is critical for the skill-manager to function later.

yaml
---
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"]
---

Workflow

  1. •Fetch Info: The agent first runs scripts/fetch_github_info.py to get the raw data from the repo.
  2. •Plan: The agent analyzes the README to understand how to invoke the tool (CLI args, Python API, etc.).
  3. •Generate: The agent uses the skill-creator patterns to write the SKILL.md and wrapper scripts, ensuring the extended metadata is present.
  4. •Verify: Checks if the commit hash was correctly captured.

Resources

  • •scripts/fetch_github_info.py: Utility to scrape/API fetch repo details (README, Hash, Tags).
  • •scripts/create_github_skill.py: Orchestrator to scaffold the folder and write the initial files.

Best Practices for Generated Skills

  • •Isolation: The generated skill should install its own dependencies (e.g., in a venv or via uv/pip) if possible, or clearly state them.
  • •Progressive Disclosure: Do not dump the entire repo into the skill. Only include the necessary wrapper code and reference the original repo for deep dives.
  • •Idempotency: The github_hash field allows the future skill-manager to check if remote_hash != local_hash to trigger updates.