# How to Share and Distribute Claude Skills via the Marketplace > Easily share and distribute Claude Skills via the marketplace. Learn how to package your skill for submission and leverage ComposioHQ tools for seamless distribution. - Repository: [Composio/awesome-claude-skills](https://github.com/composiohq/awesome-claude-skills) - Tags: how-to-guide - Published: 2026-07-26 --- **To share and distribute Claude Skills via the Marketplace, package your skill directory containing a valid [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) file into a zip archive and submit it to https://claude.ai/marketplace, using the `skill-creator` and `skill-share` automation tools from the ComposioHQ/awesome-claude-skills repository to handle scaffolding, validation, and team notifications.** Claude Skills are self-contained directories that encapsulate reusable capabilities for Anthropic's Claude AI assistant. The ComposioHQ/awesome-claude-skills repository provides two core utilities that automate the preparation and distribution workflow, ensuring your skills meet marketplace standards before publication. ## Understanding Claude Skill Structure A Claude Skill is fundamentally a directory containing specific metadata and asset files. According to the source code in [`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md), every skill requires a standardized layout including a [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) metadata file, a `scripts/` directory for executable code, a `references/` folder for documentation, and an `assets/` directory for static resources. This structure ensures that when you share and distribute Claude Skills via the marketplace, users receive a complete, functional package. ## Core Distribution Utilities The repository provides two specialized skills that form an end-to-end pipeline for marketplace distribution. ### skill-creator The `skill-creator` utility scaffolds new skills with the correct directory layout and enforces naming conventions. As defined in [`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md), this tool generates the `/skill-/` directory structure and populates the initial [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) with required front-matter fields including `name`, `description`, and `license`. ### skill-share The `skill-share` utility handles validation, packaging, and team announcements. According to [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md), this tool performs three critical functions: - **Validation**: Checks metadata compliance (lines 33-36) by verifying required fields in [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) - **Packaging**: Creates a distributable zip archive containing all skill files (lines 38-41) - **Notification**: Posts announcements to Slack channels via Rube integration (lines 43-47), including direct links to the skill files ## The Five-Step Distribution Pipeline When you share and distribute Claude Skills via the marketplace, follow this automated workflow: ### 1. Initialize Use `skill-creator` to generate a new skill directory with proper structure. Provide a unique name and description to populate the metadata template. ### 2. Validate Before packaging, `skill-share` validates that your [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) contains all required front-matter fields: `name`, `description`, and `license`. This validation logic ensures marketplace compliance before submission. ### 3. Package The packaging logic compresses all files under your skill folder into a zip archive. According to lines 38-41 in [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md), this creates a distributable package that preserves the directory structure required for installation. ### 4. Publish Upload the generated zip file to the Claude Skills Marketplace at https://claude.ai/marketplace. The marketplace accepts either the zip file directly or a public GitHub URL pointing to your skill directory. ### 5. Announce Trigger the Slack integration to notify your team. As implemented in lines 43-47 of [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md), this sends a message containing the skill name, description, and GitHub directory link to your configured Rube channel (typically `#claude-skills`). ## Marketplace Ingestion Requirements The Claude Marketplace ingests skills directly from public GitHub repositories. To successfully share and distribute Claude Skills via the marketplace, your submission must meet three strict criteria: - **Public Accessibility**: The GitHub repository must be publicly accessible - **Metadata Compliance**: The skill folder must contain a well-formed [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) with required front-matter (`name`, `description`, `license`) - **Archive Format**: The skill must be packaged as a standard zip file containing the complete directory structure When you submit a zip, the marketplace extracts it, validates the presence of [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md), and registers the skill under the name specified in that file's front-matter. After successful registration, the skill appears in the public listings at https://claude.ai/marketplace, where other users can install it directly into their Claude environment. ## Complete CLI Workflow The following example demonstrates the complete workflow using the `claude` CLI, which acts as a thin wrapper around the `skill-creator` and `skill-share` Python scripts: ```bash # 1. Create a new skill with proper scaffolding claude skill create \ --name my-awesome-skill \ --description "Summarizes PDFs and extracts key insights" # 2. Validate the generated skill metadata claude skill validate my-awesome-skill # 3. Package the skill into a distributable zip cd my-awesome-skill zip -r ../my-awesome-skill.zip . # 4. Upload to the Claude Marketplace # Navigate to https://claude.ai/marketplace → "Add new skill" → upload the zip # 5. Announce to your team via Slack (requires Rube integration) claude skill share \ --skill-dir ../my-awesome-skill \ --slack-channel "#claude-skills" ``` ## Key Source Files The implementation details for sharing and distributing Claude Skills via the marketplace are contained in the following repository files: - **[`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md)**: Defines validation, packaging, and Slack notification logic - **[`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md)**: Provides scaffolding templates for new skills - **[`README.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/README.md)** (Skills Marketplace section): Documents marketplace access and submission guidelines - **[`connect-apps-plugin/README.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/connect-apps-plugin/README.md)**: Configures the Rube-based Slack messaging integration that `skill-share` utilizes ## Summary - Claude Skills require a standardized directory structure with a [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) metadata file containing `name`, `description`, and `license` fields - The `skill-creator` utility generates compliant skill scaffolding automatically according to [`skill-creator/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-creator/SKILL.md) - The `skill-share` utility validates metadata, creates zip packages (lines 38-41), and sends Slack notifications via Rube integration (lines 43-47) - The Claude Marketplace ingests skills from public GitHub repositories as zip files, validating metadata before listing - Submit your packaged skill to https://claude.ai/marketplace to make it available for community installation ## Frequently Asked Questions ### What file format does the Claude Marketplace require for skill submissions? The marketplace requires a standard zip archive containing your complete skill directory. According to the `skill-share` implementation in [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md) (lines 38-41), you must package all files including [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md), `scripts/`, `references/`, and `assets/` into a single zip file before uploading to https://claude.ai/marketplace. ### Can I publish a Claude Skill from a private GitHub repository? No. The Claude Marketplace requires your repository to be publicly accessible to ingest and validate the skill source code. Private repositories cannot be processed by the marketplace ingestion system, though you can still use the `skill-share` utility to package skills for internal distribution via Slack notifications. ### How do I notify my team when I publish a new skill? Use the `skill-share` utility with the `--slack-channel` flag to send automated notifications. As implemented in [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md) (lines 43-47), this feature uses the Rube integration (configured in [`connect-apps-plugin/README.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/connect-apps-plugin/README.md)) to post messages containing the skill name, description, and GitHub repository link to your specified Slack channel. ### What fields are required in the SKILL.md metadata file? The [`SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/SKILL.md) file must include three critical front-matter fields: `name` (the skill identifier), `description` (functionality summary), and `license` (distribution terms). The validation logic in [`skill-share/SKILL.md`](https://github.com/ComposioHQ/awesome-claude-skills/blob/main/skill-share/SKILL.md) (lines 33-36) explicitly checks for these fields to ensure marketplace compliance before packaging.