skills.rest
mattbobambrose
mattbobambroseCOMMUNITY
Explore all skills by this author →
GitHub

port-skill

Port external SKILL.md definitions into marketplace plugins with metadata updates.

1|Updated Feb 26, 2026
Search Tags:#automation#versioning#plugin#yaml#marketplace#skill#port
One-click install
npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill port-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: port-skill
Source: https://github.com/mattbobambrose/mattbobambrose-claude-skills/tree/main/plugins/project-tools/skills/port-skill
Command: npx skills add https://github.com/mattbobambrose/mattbobambrose-claude-skills --skill port-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about port-skill

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

FAQPage Schema
How do I import an external SKILL.md into a plugin marketplace?▼

To import an external SKILL.md, you can fetch it from a URL or read a local path. The process validates YAML frontmatter, normalizes the skill name to kebab-case, creates the target skill file, and updates plugin.json and marketplace entries.

What is the best way to migrate third-party skills from GitHub into my marketplace?▼

Migrating third-party skills from GitHub involves fetching the source SKILL.md, validating required fields like name and description, and wiring it into the target plugin. This adjusts paths, bumps versions, and updates README tables to keep repository metadata consistent.

Does porting a skill require manual edits to plugin.json and README tables?▼

Porting a skill does not require manual edits to plugin.json or README tables. The process automatically handles name normalization, writes the skill file to the target plugin directory, bumps plugin and marketplace versions, and updates documentation tables.

Can I scaffold a new plugin when importing a SKILL.md file?▼

Yes, you can optionally scaffold a new plugin when importing a SKILL.md file. The process creates the directory structure at plugins/<target-plugin>/skills/<skill-name>/SKILL.md and wires the necessary marketplace entries automatically.

Why does importing a skill require YAML frontmatter validation?▼

Importing a skill requires YAML frontmatter validation to ensure the required name and description fields exist. This normalization step adapts the skill metadata to marketplace conventions, preventing errors when wiring the file into the target plugin.

Related Skills

Explore More Software Engineering Skills→
severith-aiseverith-ai

skill-md-validator

Validate skill.md files against the agent skill specification.

Community
Advanced
sequenziasequenzia
42

bump-plugin-version

Bump plugin versions in plugin.json and marketplace.json using semantic version rules.

Community
Advanced
pawan0631pawan0631

plugin-creator

Generate Codex plugin skeletons with standardized plugin.json and marketplace entries.

Community
Intermediate
EmasoftEmasoft
4

plugin-validation-skill

Validate Claude Code plugin manifests, hooks, skills, MCP servers, and marketplace entries.

Community
Advanced