gist-skills

Save and load skills to and from GitHub Gists via SKILL.md.

2|Updated Aug 3, 2021
One-click install
npx skills add https://github.com/kuboon/dotfiles --skill gist-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gist-skills
Source: https://github.com/kuboon/dotfiles/tree/main/skills/gist-skills
Command: npx skills add https://github.com/kuboon/dotfiles --skill gist-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes saving and loading skills to a GitHub Gist, addressing the friction of managing multiple skill definitions and keeping them portable across machines by centralizing SKILL.md in a gist.

Core Features & Use Cases

  • Save a skill to a gist using a structured main file named SKILL.md, with a descriptive per-skill context, so the gist contains the authoritative version.
  • Load a skill from a gist into the local skills directory at .claude/skills/<skill-name>.
  • Update, version, and synchronize skills by editing the gist and pulling changes.

Quick Start

Push the SKILL.md to a new gist and clone it into your local skill directory:

  • pushd <dir-of-the-SKILL.md>
  • git remote get-url origin If the output is not gist.github.com, run:
  • gh gist create SKILL.md -p -d "gist-skills/SKILL.md <tag> <tag> <tag>"
  • echo "<description of the skill>" | gh gist edit <gist-id> -a ".gist-skills.SKILL.md"
  • git init && git remote set-url origin <gist-url>.git If the output is https://gist.github.com/<gist-id>.git:
  • gh gist edit <gist-id> SKILL.md Finally
  • popd

Frequently Asked Questions about gist-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync local Claude skills across multiple machines using GitHub Gists?

Sync skills across machines by saving the SKILL.md file to a GitHub Gist and loading it into the local .claude/skills directory, centralizing the authoritative version for version control and portability.

What is the best way to version and share Claude skill definitions?

The best way to version and share skill definitions is by saving the SKILL.md file to a GitHub Gist, which acts as the authoritative central repository that can be updated, shared, and pulled across different machines.

Do I need the GitHub CLI to automate saving and loading skills to GitHub Gists?

Yes, automating skill management to GitHub Gists requires the GitHub CLI to execute commands like gh gist create and gh gist edit for pushing and updating the SKILL.md file.

Can I update an existing skill stored in a GitHub Gist without creating a new one?

Yes, you can update an existing skill in a GitHub Gist by using the gh gist edit command with the specific gist ID to modify the SKILL.md file directly, then pulling the changes to your local directory.

How do I load a skill from a GitHub Gist into my local Claude directory?

Loading a skill from a GitHub Gist involves cloning the gist repository into the local skills directory at .claude/skills/<skill-name>, ensuring the SKILL.md file is placed in the predictable local path.