Skip to main content

Publish Skills

Share your expertise with the AI community. Write a SKILL.md, and your skill is discoverable and installable across platforms.

What you get

Discoverable

Your skill appears in mpak search, browsable by category and tags. Developers find it when they need it.

Cross-platform

Skills follow the Agent Skills specification. They work across Claude Code, and any platform that supports the spec.

Versioned

Semantic versioning, prerelease support, and version history. Users can pin to specific versions or track latest.

One-command install

Users install with mpak skill install @you/skill. No manual copying, no configuration.

How it works

1

Write a SKILL.md

Create a SKILL.md with YAML frontmatter (name, description, category, tags) and markdown instructions that teach the AI your expertise.

SKILL.md reference →
2

Add the GitHub Action

The skill-pack action discovers SKILL.md files in your repo, validates them, packages each into a .skill bundle, and publishes to the registry.

Action documentation →
3

Create a release

Tag and push. The action discovers, validates, packages, and publishes automatically.

terminal
$git tag v1.0.0 && git push --tags
# GitHub Action runs...
✓ Found 2 skills
✓ Packed code-reviewer-1.0.0.skill
✓ Packed api-designer-1.0.0.skill
✓ Published to mpak.dev

Publishing multiple skills

The skill-pack action automatically discovers all SKILL.md files in your repository. For independent versioning across many skills, use release-please with per-skill tags.

Monorepo versioning guide →

Ready to publish?

The full guide covers SKILL.md format, frontmatter fields, categories, triggers, and more.