mcpField
G
github-to-skills

github-to-skills

github.com/kkkkhazixAgent workflows21.7k260 installsUpdated 4w ago
Repository

About github-to-skills

github-to-skills is an agent workflow skill that turns GitHub repositories into AI skills with documentation and wrapper scripts. It records repository source and version details for later management.

Key features

  1. 01Fetches repository description, README, and commit hash
  2. 02Creates a standard skill directory
  3. 03Writes SKILL.md with source and version metadata
  4. 04Generates tool wrapper scripts
  5. 05Verifies the recorded commit hash

Use cases

  1. 01Package a GitHub repository as a reusable skill
  2. 02Track a generated skill's source and version
  3. 03Create a wrapper for invoking repository tools

Install

Copy the command and run it in a terminal.

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

After installing, type/github-to-skillsin Claude Code to confirm it loaded.

Bundled filesscripts/create_github_skill.pyscripts/fetch_github_info.py

Details

From the project README

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: "

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.

---
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.

Comments

Markdown supported