github-to-skills

Original：🇺🇸 English

Translated

2 scriptsChecked / no sensitive code detected

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.

2installs

Sourcekkkkhazix/khazix-skills

Added on2026-02-04

NPX Install

npx skill4agent add kkkkhazix/khazix-skills github-to-skills

SKILL.md Content

View Translation Comparison →

GitHub to Skills Factory

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

Core Functionality

Analysis: Fetches repository metadata (Description, README, Latest Commit Hash).
Scaffolding: Creates a standardized skill directory structure.
Metadata Injection: Generates
```
SKILL.md
```
with extended frontmatter (tracking source, version, hash) for future automated management.
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

Fetch Info: The agent first runs
```
scripts/fetch_github_info.py
```
to get the raw data from the repo.
Plan: The agent analyzes the README to understand how to invoke the tool (CLI args, Python API, etc.).
Generate: The agent uses the
```
skill-creator
```
patterns to write the
```
SKILL.md
```
and wrapper scripts, ensuring the extended metadata is present.
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.