codex-plugins-guide

Create and validate Codex plugin manifests and marketplace registrations.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/tvishwanadha/skills --skill codex-plugins-guide
Or copy as Structured Prompt for Agent
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.