port-skill

What problem does it solve?

Porting standalone Skill definitions into an existing marketplace requires many repetitive, error-prone edits across multiple files (skill metadata, plugin manifests, marketplace entries, and README tables). This Skill automates reading or fetching a source SKILL.md, validating its frontmatter, adapting naming and paths to marketplace conventions, creating the target skill file, and bumping versions and documentation to keep the marketplace consistent.

Core Features & Use Cases

• Fetch and Read: Read a SKILL.md from a local path or fetch it from a URL and parse its YAML frontmatter.
• Validate and Normalize: Ensure required fields (name, description) exist, normalize the skill name to kebab-case, and adjust description format to the marketplace style.
• Wire into Marketplace: Create plugins/<target-plugin>/skills/<skill-name>/SKILL.md, bump plugin and marketplace versions, and update plugin README tables; optionally scaffold a new plugin if requested.
• Use Case: Migrate a third-party skill published on GitHub into your marketplace while preserving logic and ensuring the repository and marketplace metadata remain consistent.

Quick Start

Port the SKILL.md at https://github.com/example/awesome-skill/SKILL.md into the target plugin project-tools and update the plugin version and README.