codex-plugins-guide

Create and validate Codex plugin manifests and marketplace registrations.

Updated Feb 15, 2026

Search Tags:#documentation #validation #codex #discovery #plugin #manifest #marketplace

Ready to run

npx skills add https://github.com/tvishwanadha/skills --skill codex-plugins-guide

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: codex-plugins-guide
Source: https://github.com/tvishwanadha/skills/tree/main/.claude/skills/codex-plugins-guide
Command: npx skills add https://github.com/tvishwanadha/skills --skill codex-plugins-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill should be loaded when creating or modifying a Codex plugin manifest (.codex-plugin/plugin.json), registering a plugin in the Codex marketplace (.agents/plugins/marketplace.json), adding interface metadata, or troubleshooting Codex plugin discovery. Defines Codex-specific marketplace conventions for this repository.

Core Features & Use Cases

Guides the structure and fields for Codex plugin manifests and marketplace registrations
Helps maintain consistent interface metadata and plugin discovery across Codex ecosystems
Serves as a reference for authors and maintainers when creating or updating Codex plugin artifacts

Quick Start

Follow the Codex plugin conventions when creating or updating a Codex plugin manifest or marketplace entry to ensure it is discoverable and compliant.

Frequently Asked Questions about codex-plugins-guide

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

FAQPage Schema

How do I create a Codex plugin manifest?▼

To create a Codex plugin manifest, define the .codex-plugin/plugin.json file by specifying and validating the manifest structure, interface metadata, and recommended fields to satisfy Codex plugin guidelines.

How do I register a plugin in the Codex marketplace?▼

To register a plugin in the Codex marketplace, update the .agents/plugins/marketplace.json file by following Codex-specific marketplace conventions to ensure your plugin is discoverable and compliant.

Why is my Codex plugin not showing up in discovery?▼

Codex plugin discovery fails when the manifest structure or interface metadata is non-compliant; troubleshoot by validating your .codex-plugin/plugin.json against Codex plugin guidelines and marketplace conventions.

What fields are required for a valid Codex plugin manifest?▼

A valid Codex plugin manifest requires a defined structure and specific interface metadata; validating recommended fields in .codex-plugin/plugin.json ensures compliance with Codex plugin guidelines.

How do I update interface metadata for an existing Codex plugin?▼

To update interface metadata, modify the .codex-plugin/plugin.json file and validate the changes against Codex plugin guidelines to maintain consistent plugin discovery across the Codex ecosystem.

When do I need to modify the Codex marketplace.json file?▼

You need to modify the Codex marketplace.json file when registering a new plugin or updating an existing plugin's marketplace entry to maintain consistent discovery and compliance.