upload-skills

Publish local Claude Code skills to a GitHub repository with automated README and index updates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MitchellX/awesome-skills --skill upload-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upload-skills
Source: https://github.com/MitchellX/awesome-skills/tree/main/skills/upload-skills
Command: npx skills add https://github.com/MitchellX/awesome-skills --skill upload-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates publishing a local Claude Code skill to a central GitHub repository, reducing manual steps and ensuring consistency across submissions.

Core Features & Use Cases

  • One-command upload: Publish any local skill with a single /upload-skills command.
  • Auto README generation: Creates a detailed README.md from the skill's SKILL.md metadata.
  • Repo index updates: Automatically updates the repository's root README and the available skills table.
  • Git integration: Handles pull, commit, and push in a streamlined workflow.

Quick Start

Run /upload-skills <skill-name> to publish a local Claude Code skill to MitchellX/awesome-skills.

Frequently Asked Questions about upload-skills

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

FAQPage Schema
How do I publish a local Claude Code skill to GitHub?

To publish a local Claude Code skill to GitHub, use the /upload-skills command to automate validation, file copying, README generation, and git push to the awesome-skills repository.

What is the best way to automate uploading a Claude skill to a central repository?

Automating a Claude skill upload to a central repository is best done with a single command that handles repository preparation, index updates, and git operations, ensuring submission consistency.

Do I need a SKILL.md file to upload a local skill to GitHub?

Yes, you need a well-formed SKILL.md file in your local ~/.claude/skills folder to upload a skill, as its metadata is required to generate the per-skill README and update the repository index.

Can I automatically generate a README when publishing a Claude skill?

Yes, you can automatically generate a README when publishing a Claude skill, as the upload workflow extracts metadata from SKILL.md to create a detailed README.md for the repository.

Does the Claude skill upload process handle git pull and push automatically?

Yes, the Claude skill upload process handles git integration automatically, streamlining the workflow by executing repository pulls, commits, and pushes without manual intervention.

What happens if my local skill folder is missing SKILL.md metadata?

If your local skill folder is missing SKILL.md metadata, the upload process will fail during validation because the file is required to generate the README and update the repository index.