Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mains.dev/llms.txt

Use this file to discover all available pages before exploring further.

The Plugins page is a single browsing surface for two related but distinct ecosystems:
  • Plugins — official Codex plugins published through the OpenAI marketplace (GitHub, Linear, Jira, Asana, Trello, Sentry, Computer Use, and more)
  • Skills — third-party reusable agent skills from skills.sh, installable via npx skills add <url>
Both are managed from the same page using a tab switcher. Open it from the sidebar at any time — it’s a top-level destination, not a settings panel.

Plugins (Codex Marketplace)

Plugins extend Codex with curated integrations — each one bundles together skills, MCP servers, and apps that target a specific platform or capability. Browsing them inside Mains uses the same marketplace API as the Codex VS Code extension, so the catalog is always in sync.

Browsing

ElementWhat it shows
Plugin cardLogo, brand color, display name, short description, install button
Detail pageLong description, screenshots, included items (skills, apps, MCP servers), install policy
Connected badgeGreen pill on apps that are already authenticated and ready to use
Install policyNOT_AVAILABLE plugins are disabled with a tooltip explaining why

Installing

1

Pick a plugin

Click any card to open the detail view. You’ll see screenshots, a long description, and the list of items the plugin includes.
2

Click Add

Mains forwards the install request to your Codex account. Plugins that need OAuth open the connector flow in a browser window.
3

Use it in a Codex run

The plugin’s tools become available to the Codex agent on the next run. You can also see it listed under Installed plugins in Settings.
To remove a plugin, click Uninstall on its detail page. Mains revokes the install and refreshes the catalog automatically.

What’s Inside a Plugin

Plugins compose three primitives:
TypeDescription
SkillsMarkdown-defined behaviors the agent can invoke (e.g. “address PR comments”)
AppsOAuth-connected services (e.g. GitHub, Linear) that expose actions and data
MCP serversMCP-compatible servers that ship with the plugin
The detail page shows every included item with a status pill — Connected, Disabled, or a link to install the underlying app if it’s missing.

Skills (skills.sh)

The Skills tab browses third-party skills published on skills.sh. Unlike Codex plugins, skills are not tied to OpenAI’s marketplace — anyone can publish one, and they install via a CLI command.

Views

ViewWhat it shows
CuratedEditor-picked groupings (e.g. “Daily standups”, “Release management”)
TrendingSkills with the most installs in the last 24 hours
HotRecent skills with strong engagement
All-timeMost-installed skills overall
A search bar at the top filters across all views.

Installing a Skill

Skills install through the standalone skills CLI — Mains shows you the exact command to copy:
npx skills add https://skills.sh/<owner>/<slug>
Open the skill detail page to see its description, owner, install URL, and a one-click copy button for the install command. Run it in your terminal — the skill appears in your ~/.claude/skills/ (or .{your_project}/skills/) directory and is picked up on the next agent run.
Skills installed via npx skills add work with both Claude Code and Cursor runtimes. See Skills for the directory layout and frontmatter format.

Plugins vs. Skills — Quick Reference

FeaturePluginsSkills
CatalogOpenAI Codex marketplaceskills.sh community
RuntimeCodex onlyClaude Code + Cursor
Install flowOne-click from the UICopy npx skills add command and run it
IncludesSkills + apps + MCP servers (bundled)Single SKILL.md or skill folder
AuthOAuth handled by the marketplaceNone (local files only)
  • Skills — skill file format and how the agents discover them
  • MCP Servers — adding MCP servers manually outside the marketplace
  • Computer Use — one of the most-used Codex plugins