How does it handle merge conflicts during a sync?

The skill detects when a push is rejected due to diverged branches and provides guided options to pull and rebase, merge, or resolve conflicts manually.

Does it automatically update documentation?

Yes, it includes a step to run a README generation script that extracts descriptions from your skills and creates a formatted index table in your repository.

Can I sync just one specific skill instead of my whole library?

Yes, the skill supports 'Single Skill Sync' mode by specifying the skill name, or 'Batch Sync' mode to update everything at once.

What is the primary purpose of this Claude Code skill?

It automates the process of taking local Claude Agent Skills from your machine and pushing them to a GitHub repository while simultaneously updating a Notion tracking database.

What are the environment requirements?

You need Claude Code running in a terminal with git installed, GitHub authentication configured, and access to the Notion AI Building Blocks database.

Skill Sync to GitHub

Name: Skill Sync to GitHub
Author: jamesgray-ai

byjamesgray-ai

•

Productivity & Workflow

Automates the synchronization of local Claude Agent Skills to GitHub with semantic commits and Notion database updates.

This skill streamlines the lifecycle management of Claude Agent Skills by bridging the gap between local development and cloud backup. It automatically detects changes in your local skills directory, generates descriptive semantic commit messages, and pushes updates to GitHub. Beyond version control, it synchronizes metadata with a Notion 'AI Building Blocks' database, ensuring your project tracking stays perfectly aligned with your actual code deployments. It is an essential utility for developers maintaining a growing library of AI agent capabilities who require professional-grade versioning and documentation automation.

Key Features

01Automatic change detection using git status across local skill directories

02Automated Notion API integration to update skill status and repository URLs

033 GitHub stars

04Semantic commit message generation (CREATE, UPDATE, FIX) based on modifications

05Auto-generation of a repository README.md to maintain an indexed skill catalog

06Seamless GitHub integration for remote backup and multi-device versioning

Use Cases

01Backing up newly created Claude skills to a centralized version-controlled repository

02Performing batch syncs of multiple skill updates after local testing and refinement

03Maintaining a live Notion dashboard of all deployed AI agent capabilities and their locations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamesgray-ai/handsonai syncing-skills-to-github

For use in Claude.ai and ChatGPT

Download Skill