skills.rest
akiojin
akiojinCOMMUNITY
Explore all skills by this author →
Website𝕏@akiojinGitHub

skills-repo-maintenance

Package Codex skills and Claude Code plugins via marketplace.json and plugin.json workflows.

8|3|Updated Dec 10, 2025
Search Tags:#codex#plugin#repository#publish#marketplace#claude-code#skill-packaging
One-click install
npx skills add https://github.com/akiojin/skills --skill skills-repo-maintenance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skills-repo-maintenance
Source: https://github.com/akiojin/skills/tree/main/skills-repo-maintenance
Command: npx skills add https://github.com/akiojin/skills --skill skills-repo-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maintain and synchronize a skills repository for Codex and Claude Code, simplifying the creation of new skills, packaging Codex .skill files, and converting skills into Claude Code plugins (marketplace.json + plugin.json).

Core Features & Use Cases

  • Unified workflow: Create or update the Skill content at the repository root with an SKILL.md that includes a YAML frontmatter with name and description.
  • Dual-runtime support: Prepare skills for Codex distribution and Claude Code plugin integration (marketplace.json, plugin.json).
  • Packaging and documentation: Organize extra materials under references/, scripts/, and assets/ and ensure proper packaging and commit workflows.
  • Future extensibility: Add or update plugins and skill artifacts across the ecosystem in a single, auditable process.

Quick Start

Create or update SKILL.md at the repo root and follow the workflow to publish Codex skills and Claude Code plugins.

Frequently Asked Questions about skills-repo-maintenance

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

FAQPage Schema
How do I package a Codex skill and publish it as a Claude Code plugin?▼

To package and publish Codex skills and Claude Code plugins, you create an SKILL.md at the repo root with YAML frontmatter, then use marketplace.json and plugin.json workflows to synchronize and distribute the packaged artifacts across both runtimes.

What is the required YAML frontmatter format for a Codex SKILL.md file?▼

The YAML frontmatter in a SKILL.md file must include the skill name and description fields to pass validation. This metadata is required for the skill to be recognized and packaged correctly for Codex and Claude Code distribution.

Can I include extra scripts and assets when publishing Claude Code plugins?▼

Yes, you can include optional resources by organizing extra materials under references/, scripts/, and assets/ directories. The workflow ensures these supplementary files are properly packaged and committed alongside the core SKILL.md.

Does the skills-repo-maintenance workflow support both Codex and Claude Code runtimes?▼

Yes, the workflow applies to both Codex skills at repository roots and Claude Code plugins via marketplace.json and plugin.json, providing a unified, auditable process to manage skill artifacts across both runtimes.

Related Skills

Explore More Software Engineering Skills→
Hung-3008Hung-3008
1

market-research-reports

Extract and structure metadata from a repository into a YAML block.

Community
Advanced
bbrowningbbrowning
2

Creating and Managing Plugin Marketplaces

Create Claude Plugin marketplaces with manifest files and git workflows.

Community
Basic
lusya123lusya123

Plugin Settings

Store per-project plugin settings in YAML frontmatter within .claude/plugin-name.local.md files.

Community
Intermediate
tianzecntianzecn
2

release

Automate version bumps, marketplace.json updates, git tagging, and release documentation for MAG Claude Plugins.

Community
Advanced