Skip to content
Development
Command

/update-readme

Update README.md plugin sections and download links

From plugin
claude-codex-settings
1k15 skills4 agents15 commands
Install
$ npx -y skills add fcakyon/claude-codex-settings --agent claude-code

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/update-readme

Context preview

What this command does when you run it.

Update README.md plugin sections and download links

Command definition

update-readme.md
allowed-tools: Read, Glob, Grep, Edit
description: Update README.md plugin sections and download links

Update README.md

Regenerate the Plugins section of README.md based on current plugin structure and marketplace data.

Steps

1. Read `.claude-plugin/marketplace.json` to get the full list of plugins with descriptions, versions, and metadata.

2. For each plugin, scan `plugins/<name>/` to discover:

  • Skills: `plugins/<name>/skills/*/SKILL.md`
  • Commands: `plugins/<name>/commands/*.md`
  • Agents: use `.claude-plugin/plugin.json` `agents` paths when set, otherwise `plugins/<name>/agents/*.md`
  • Hooks: use `.claude-plugin/plugin.json` `hooks` paths when set, otherwise `plugins/<name>/hooks/hooks.json`
  • MCP: `plugins/<name>/.mcp.json`

3. Update each plugin's `<details>` block in README.md. Use this format:

<details>
<summary><strong>plugin-name</strong> - Short description</summary>

| Claude Code                                   | Codex CLI                                                                     | Gemini CLI                                               |
| --------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------- |
| `/plugin install plugin-name@claude-settings` | Open `/plugins` -> `Claude & Codex Settings` -> install `plugin-name` | `gemini extensions install --path ./plugins/plugin-name` |

**Skills CLI**

```bash
npx skills add https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/plugin-name --skill '*'

One-line description.

**Skills:**

  • [`skill-name`](./plugins/plugin-name/skills/skill-name/SKILL.md) - Description from SKILL.md frontmatter

**Commands:** (if any)

  • [`/plugin-name:cmd`](./plugins/plugin-name/commands/cmd.md) - Description from frontmatter

**Agents:** / **Hooks:** / **MCP:** (if applicable)

</details>


4. Only add the `Skills CLI` block when `plugins/<name>/skills/*/SKILL.md` exists.
   - For plugins without local skills, omit the `Skills CLI` block.
   - Do not add a global `Skills CLI` section under `## Installation`.
   - Do not add `--list`.
   - Do not add per-skill `npx skills add` commands.
   - Do not add a `Skills CLI` column to skill tables.
   - Do not mention maintainer sync scripts.
   - Do not link to `skills.sh`.

5. For skill-only plugins (no MCP, no commands), use a table with ZIP download badges:

```markdown
**Skills** (ZIP for claude.ai, Claude Code, Cursor, Codex, VS Code):

| Skill                                                            | Description | ZIP                                                                                                                                                                |
| ---------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [`skill-name`](./plugins/plugin-name/skills/skill-name/SKILL.md) | Description | [![ZIP](https://img.shields.io/badge/⬇%20ZIP-2ea44f?style=flat-square)](https://github.com/fcakyon/claude-codex-settings/releases/latest/download/skill-name.zip) |

6. Also update the Installation section if plugin names have changed.

7. Do NOT modify non-plugin sections (header, Configuration, Statusline, TODO, References, Star History).

Read more
Ships withclaude-codex-settings

Battle-tested Claude Code, OpenAI Codex, Cursor configs, plugins, hooks and agents with Kimi, MiniMax and GLM API support.

Get the whole plugin, auto-invoked
Stats
1,018
Stars
1
Views
89
Forks
Active
Maintenance
Python
Language
Apache-2.0
License
9h ago
Last commit
1y ago
Created

Repo: fcakyon/claude-codex-settings