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.