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

Ready to run

npx skills add https://github.com/akiojin/skills --skill skills-repo-maintenance

💬 Prompt for ChatGPT / Claude Chat▼

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.