skills.rest
am-will
am-willCOMMUNITY
Explore all skills by this author →
GitHub

pluginstaller

Installs Codex plugins from GitHub repos into repo or personal marketplaces.

1.0k|58|Updated Jan 16, 2026
Search Tags:#plugin#Marketplace#install#gitHub#CODEX#agent tooling#Manifest
One-click install
npx skills add https://github.com/am-will/codex-skills --skill pluginstaller
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pluginstaller
Source: https://github.com/am-will/codex-skills/tree/main/skills/pluginstaller
Command: npx skills add https://github.com/am-will/codex-skills --skill pluginstaller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Installing a Codex plugin from a GitHub repository requires correctly copying the plugin bundle, validating its manifest, and registering it in a marketplace file; doing this manually is error-prone and easy to get wrong.

Core Features & Use Cases

  • Plugin Discovery and Validation: Locates the plugin root via .codex-plugin/plugin.json and validates required fields like name, version, and description.
  • Scoped Installation: Copies the full plugin bundle to the correct location for either a repo marketplace ($CWD/plugins/) or a personal marketplace (~/.codex/plugins/).
  • Marketplace Registration: Creates or merges a marketplace.json entry with the documented schema, including source path, installation policy, authentication policy, and category.
  • Use Case: A teammate shares a GitHub repo containing a Codex plugin; use this Skill to install it into your personal marketplace so it appears in /plugins across all your projects after restarting Codex.

Quick Start

Use pluginstaller to install the Codex plugin from this GitHub repo into my personal marketplace.

Frequently Asked Questions about pluginstaller

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

FAQPage Schema
How do I install a Codex plugin from a GitHub repo?▼

Provide the GitHub repo URL or owner/repo and choose an install scope. The Skill locates .codex-plugin/plugin.json, validates the manifest, copies the full plugin directory, and registers it in the appropriate marketplace.json file.

What is the difference between repo and personal marketplace scope?▼

Repo scope installs the plugin to $CWD/plugins/ with a marketplace file at $CWD/.agents/plugins/marketplace.json, shared through that repo. Personal scope installs to ~/.codex/plugins/ with a marketplace at ~/.agents/plugins/marketplace.json, available across your projects.

Why does my installed Codex plugin not appear in /plugins?▼

The plugin only becomes discoverable through its marketplace entry, not just by copying files. Verify the marketplace.json entry exists with a valid source.path, then restart Codex and check /plugins again.

What files are required in a valid Codex plugin?▼

A valid plugin needs .codex-plugin/plugin.json containing name, version, and description, with bundled paths like skills, apps, and mcpServers relative to the plugin root and prefixed with ./. Only plugin.json should live inside .codex-plugin/.

Can I install a plugin from a repo containing multiple plugins?▼

Yes, but you must specify which plugin folder to install when the repo contains more than one plugin root. The Skill asks for clarification rather than guessing which plugin directory to use.

Related Skills

Explore More Software Engineering Skills→
tvishwanadhatvishwanadha

codex-plugins-guide

Create and validate Codex plugin manifests and marketplace registrations.

Community
Intermediate
xiaolaixiaolai
111

conventions-codex

Enforces Codex CLI artifact layout, manifests, and hook conventions for Tier 2-Codex scoring.

Community
Intermediate
soo-kate-yeonsoo-kate-yeon

moai-foundation-Codex

Author and manage Codex skills, sub-agents, plugins, and configuration.

Community
Advanced
ianphilianphil
11

packages

Install, remove, list, and update Genesis packages from GitHub repositories.

Community
Intermediate