Back to Skills

publish-skill

verified

USE WHEN: user wants to publish, port, or share a skill to a marketplace repo. DO NOT USE WHEN: creating new skills, installing skills, or general questions.

View on GitHub

Marketplace

claude-hacks

mahidalhan/claude-hacks

Plugin

publish-skill

Repository

mahidalhan/claude-hacks
20stars

skills/publish-skill/skills/publish-skill/SKILL.md

Last Verified

January 22, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/mahidalhan/claude-hacks/blob/main/skills/publish-skill/skills/publish-skill/SKILL.md -a claude-code --skill publish-skill

Installation paths:

Claude
.claude/skills/publish-skill/
Powered by add-skill CLI

Instructions

# Publish Skill to Marketplace

Port skills from any project to the claude-hacks marketplace.

## Usage

```bash
publish-skill <skill-name> [--source PATH] [--dry-run] [--no-push]
```

## What It Does

1. Copies skill to `skills/<name>/skills/<name>/`
2. Updates `.claude-plugin/marketplace.json`
3. Bumps version if exists, adds new entry if not
4. Commits and pushes

## Examples

```bash
publish-skill my-skill
publish-skill my-skill --source /path/to/.claude/skills/my-skill
publish-skill my-skill --dry-run
```

## Pre-Publish Check

Verify SKILL.md has:
- `name:` in frontmatter
- `description:` with USE WHEN / DO NOT USE WHEN

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
624 chars