Skip to content
Back to search

awesome-agent-config

Agent-guided configuration for Claude Code and Codex: shared skills, native plugins, independent instructions and memory, with one conversational setup.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mizoreww--awesome-agent-config/badge.svg)](/listings/mizoreww--awesome-agent-config)

HTML

<a href="/listings/mizoreww--awesome-agent-config"><img src="/api/listings/mizoreww--awesome-agent-config/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The active release line is [Mizoreww/awesome-agent-config](https://github.com/Mizoreww/awesome-agent-config) on `main`. Upgrading from the previous repository name or development branch? Follow the [v4 migration notes](docs/migration.md#repository-identity).

Open this checkout in Claude or Codex, or share **the URL of the repository page you are reading** along with the request below. Keep its branch/ref when sharing a branch page.

> Read INSTALL.md from the checkout or repository page I shared, using the same branch/revision as its README. Configure the agent I am talking to. Detect my OS, client and existing configuration. Directly in this conversation, list every option supported by this agent by category with continuous numbers, a useful description, author recommendations and installed status. Prefer native multi-select questions when available; otherwise let me choose multiple numbers or names in chat. Keep the choices in the conversation; do not generate a separate Markdown document or report. Install and verify my choices, preserving my customizations.

The agent shows only your target agent's supported options directly in the conversation, with useful descriptions and recommendations. If the client offers a real multi-select question tool, choose options by category there; otherwise reply with multiple numbers, names or a description of what you want. The agent respects the tool's actual limits and reuses choices you already made. A plugin bundle gets one number and lists its members; capabilities included in that bundle are not installed twice. Author recommendations follow the recorded legacy main/Codex installer defaults and subsequent changes, with [explicit mappings](catalog.md#recommendations): 20 Claude and 18 Codex recommendations in this release. Recommendations do not select items for you.

For later changes, say “add asd-ste100”, “update my previous selections” or “remove storage-analyzer”. Existing choices are reused; omitting an installed item never uninstalls it. Both agents use `edit-config` for configuration queries, additions, edits, removals, repairs and updates. It tracks this repository’s `main` branch. Queries are read-only; if the skill is absent, the global instructions link to the same workflow.

Native plugin/MCP commands are preferred; the agent chooses source installation when the documented scope or client requires it. You do not need to choose between npx, plugins and skill copies yourself. Codex setup disables external-agent auto-import so installations follow your selections. Windows and WSL are detected and configured separately; App/CLI installations sharing a home are reused.

For Codex, the agent checks the available OpenAI official/curated directory, then upstream Codex packages and verified compatible plugins. The [plugin guide](platforms/codex/plugins.md) records exact routes and limitations; official availability depends on the account and client. Existing equivalent capabilities are reused.

[Installation workflow](INSTALL.md) · [Claude operations](platforms/claude/README.md) · [Codex operations](platforms/codex/README.md) · [Full catalogue and bundle members](catalog.md)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 209 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <!-- Keep the user-facing tables aligned with catalog.md and README.zh-CN.md. -->
  2. **English** | [中文](README.zh-CN.md) | [Changelog](CHANGELOG.md)
  3. # Awesome Agent Config
  4. ![Claude Statusline](assets/statusline.png)
  5. One repository for [Claude Code](https://claude.com/claude-code) and [Codex](https://developers.openai.com/codex/): global instructions, coding rules, plugins, shared skills, status lines and correction memory. Your existing agent detects the platform, explains the options and installs your choices. The same conversation works on macOS, Linux, Windows and WSL, with commands checked against the local client.
  6. ## Showcase
  7. ![Claude Code Demo](images/claude-code-demo.png)
  8. - [adversarial-review skill — worked example](docs/adversarial-review-showcase.md)
  9. ## Quick Start
  10. The active release line is [Mizoreww/awesome-agent-config](https://github.com/Mizoreww/awesome-agent-config) on `main`. Upgrading from the previous repository name or development branch? Follow the [v4 migration notes](docs/migration.md#repository-identity).
  11. Open this checkout in Claude or Codex, or share **the URL of the repository page you are reading** along with the request below. Keep its branch/ref when sharing a branch page.
  12. > Read INSTALL.md from the checkout or repository page I shared, using the same branch/revision as its README. Configure the agent I am talking to. Detect my OS, client and existing configuration. Directly in this conversation, list every option supported by this agent by category with continuous numbers, a useful description, author recommendations and installed status. Prefer native multi-select questions when available; otherwise let me choose multiple numbers or names in chat. Keep the choices in the conversation; do not generate a separate Markdown document or report. Install and verify my choices, preserving my customizations.
  13. The agent shows only your target agent's supported options directly in the conversation, with useful descriptions and recommendations. If the client offers a real multi-select question tool, choose options by category there; otherwise reply with multiple numbers, names or a description of what you want. The agent respects the tool's actual limits and reuses choices you already made. A plugin bundle gets one number and lists its members; capabilities included in that bundle are not installed twice. Author recommendations follow the recorded legacy main/Codex installer defaults and subsequent changes, with [explicit mappings](catalog.md#recommendations): 20 Claude and 18 Codex recommendations in this release. Recommendations do not select items for you.
  14. For later changes, say “add asd-ste100”, “update my previous selections” or “remove storage-analyzer”. Existing choices are reused; omitting an installed item never uninstalls it. Both agents use `edit-config` for configuration queries, additions, edits, removals, repairs and updates. It tracks this repository’s `main` branch. Queries are read-only; if the skill is absent, the global instructions link to the same workflow.
  15. Native plugin/MCP commands are preferred; the agent chooses source installation when the documented scope or client requires it. You do not need to choose between npx, plugins and skill copies yourself. Codex setup disables external-agent auto-import so installations follow your selections. Windows and WSL are detected and configured separately; App/CLI installations sharing a home are reused.
  16. For Codex, the agent checks the available OpenAI official/curated directory, then upstream Codex packages and verified compatible plugins. The [plugin guide](platforms/codex/plugins.md) records exact routes and limitations; official availability depends on the account and client. Existing equivalent capabilities are reused.
  17. [Installation workflow](INSTALL.md) · [Claude operations](platforms/claude/README.md) · [Codex operations](platforms/codex/README.md) · [Full catalogue and bundle members](catalog.md)
  18. ## Catalogue
  19. The tables retain the original categories and merge the Claude and Codex capabilities. Third-party originals are installed from their upstream sources; this repository stores author-owned and intentionally customized skills with attribution. Handoff belongs to the Matt bundle only. `—` means this repository does not offer that item for the agent. The agent hides those entries when presenting your choices. A platform cell marked **★** identifies an author recommendation for that agent. Exact routes, stable IDs and recommendation markers live in [catalog.md](catalog.md).
  20. ### Core
  21. | Item | Source | What It Does | Claude | Codex |
  22. | --- | --- | --- | --- | --- |
  23. | **CLAUDE.md / AGENTS.md** | [Repository](platforms/claude/README.md#configuration) | Separate global instructions for each agent | Template ★ | Template ★ |
  24. | **Base settings** | [Repository](platforms/codex/README.md#configuration) | Partially merge model, reasoning and runtime settings | Template ★ | Template ★ |
  25. | **Permissions** | [Repository](platforms/codex/README.md#configuration) | Optional high-autonomy permissions for a user-selected trusted environment | Template ★ | Template ★ |
  26. | **Writing style rule** | [Repository](platforms/claude/README.md#configuration) | Complete English writing requirements and examples; replaces the previous common rules | Rule ★ | — |
  27. | **StatusLine** | [Repository](platforms/claude/README.md#configuration) | Claude gradient context/usage bar and fonts; Codex native footer | Template ★ | Template ★ |
  28. | **Lessons** | [Repository](platforms/codex/README.md#configuration) | Independent blank global logs and memory routing; preserve real corrections | Template ★ | Template ★ |
  29. ### Language Rules
  30. | Item | Source | What It Does | Claude | Codex |
  31. | --- | --- | --- | --- | --- |
  32. | **Python rules** | [Repository](platforms/claude/README.md#configuration) | PEP 8, pytest, type hints and bandit | Template | — |
  33. | **TypeScript rules** | [Repository](platforms/claude/README.md#configuration) | Zod, Playwright and immutability | Template | — |
  34. | **Go rules** | [Repository](platforms/claude/README.md#configuration) | gofmt, table-driven tests and gosec | Template | — |
  35. ### Review
  36. | Item | Source | What It Does | Claude | Codex |
  37. | --- | --- | --- | --- | --- |
  38. | **Claude code-review** | [Anthropic](https://github.com/anthropics/claude-plugins-official) | Confidence-based pull request review | Native plugin ★ | — |
  39. | **Matt code-review** | [Matt Pocock](https://github.com/mattpocock/skills) | Separate Standards and Spec reviews; a standalone choice on Codex | In Matt bundle | Selected source ★ |
  40. | **adversarial-review** | [poteto/noodle](https://github.com/poteto/noodle/blob/main/.agents/skills/adversarial-review/SKILL.md) | Cross-model review through Skeptic, Architect and Minimalist lenses | Bundled skill ★ | — |
  41. | **codex-in-claude** | [OpenAI](https://github.com/openai/codex-plugin-cc) | Call Codex CLI from Claude; choose alongside review tools according to need | Native plugin | — |
  42. ### Workflow
  43. | Item | Source | What It Does | Claude | Codex |
  44. | --- | --- | --- | --- | --- |
  45. | **andrej-karpathy-skills** | [Karpathy skills](https://github.com/forrestchang/andrej-karpathy-skills) | Think before coding, keep changes focused, define verifiable outcomes | Native plugin ★ | Plugin / source ★ |
  46. | **superpowers** | [obra / OpenAI curated](https://github.com/obra/superpowers) | Brainstorming, debugging, TDD, worktrees and planning; 14-skill bundle | Native plugin | Plugin / source |
  47. | **mattpocock-skills** | [Matt Pocock](https://github.com/mattpocock/skills) | Planning, TDD, research, grilling and delivery; Claude full package, Codex 20 selected v1.1.0 skills, including handoff | Native plugin ★ | Selected source ★ |
  48. | **neat-freak** | [khazix-skills](https://github.com/KKKKhazix/khazix-skills/tree/2b4a645cfdc894156ae347d897723562f719ce95/neat-freak) | Reconcile project docs, agent rules, authorized memory and workspace residue | Upstream install ★ | Upstream install ★ |
  49. | **code-simplifier** | [Anthropic](https://github.com/anthropics/claude-plugins-official) | Code simplification and refactoring agent | Native plugin ★ | — |
  50. | **edit-config** | [Repository](skills/edit-config/SKILL.md) | Inspect and manage configuration on main; shared by both agents | Bundled skill ★ | Bundled skill ★ |
  51. ### Integrations
  52. | Item | Source | What It Does | Claude | Codex |
  53. | --- | --- | --- | --- | --- |
  54. | **context7** | [Upstash](https://github.com/upstash/context7) | Up-to-date library documentation lookup | Native plugin ★ | Plugin / MCP ★ |
  55. | **playwright** | [Microsoft](https://github.com/microsoft/playwright-mcp) | Browser automation, E2E testing and screenshots; Codex MCP pinned to 0.0.78 | Native plugin ★ | MCP ★ |
  56. ### Design & Content
  57. | Item | Source | What It Does | Claude | Codex |
  58. | --- | --- | --- | --- | --- |
  59. | **document-skills** | [Anthropic](https://github.com/anthropics/skills) | PDF, DOCX, PPTX and XLSX creation and editing; reuse equivalent built-in Codex tools | Native plugin ★ | Built-in / compatible plugin / source ★ |
  60. | **example-skills** | [Anthropic](https://github.com/anthropics/skills) | Claude: 12 examples; Codex: canvas-design, algorithmic-art and mcp-builder | Native plugin ★ | Selected source ★ |
  61. | **frontend-design** | [Anthropic](https://github.com/anthropics/claude-plugins-official) | Distinctive frontend interfaces; reused when already supplied by the examples bundle | Native plugin ★ | Plugin / source ★ |
  62. | **humanizer** | [blader](https://github.com/blader/humanizer) | Remove mechanical AI writing patterns in English | Plugin / source ★ | Upstream install ★ |
  63. | **humanizer-zh** | [op7418](https://github.com/op7418/Humanizer-zh) | Remove mechanical AI writing patterns in Chinese | Upstream install | Upstream install |
  64. | **lieflat-charts** | [lieflat-charts](https://github.com/larashero3-dotcom/lieflat-charts) | Lupi / Basics / Glance / Maps HTML galleries and 12 bilingual report templates; source excludes preview media; noncommercial use only | Selected source | — |
  65. ### Slides
  66. | Item | Source | What It Does | Claude | Codex |
  67. | --- | --- | --- | --- | --- |
  68. | **frontend-slides** | [zarazhangrui](https://github.com/zarazhangrui/frontend-slides) | Zero-dependency HTML slide generation with PPT conversion and varied styles | Native plugin | Compatible plugin / source |
  69. | **ppt-master** | [hugohe3](https://github.com/hugohe3/ppt-master) | Editable PPTX from PDF / DOCX / URL / Markdown, with shapes and animations; runtime setup on first use | Native plugin | Selected source |
  70. ### Memory & Lifestyle
  71. | Item | Source | What It Does | Claude | Codex |
  72. | --- | --- | --- | --- | --- |
  73. | **claude-health** | [tw93](https://github.com/tw93/claude-health) | Health and wellness dashboard for Claude sessions | Native plugin | — |
  74. ### Storage
  75. | Item | Source | What It Does | Claude | Codex |
  76. | --- | --- | --- | --- | --- |
  77. | **storage-analyzer** | [khazix-skills (modified)](https://github.com/KKKKhazix/khazix-skills/tree/fcba3adcf5def1ccd4bb688de93060227471b129/storage-analyzer) | Read-only disk analysis and an interactive HTML report with guarded cleanup; includes Linux support and security fixes | Bundled skill | Bundled skill |
  78. ### Academic Research
  79. | Item | Source | What It Does | Claude | Codex |
  80. | --- | --- | --- | --- | --- |
  81. | **asd-ste100** | [danyuchn/asd-ste100-skill](https://github.com/danyuchn/asd-ste100-skill) | ASD-STE100 Simplified Technical English writing rules and linter; with Claude Code's built-in dataviz it covers the paper explanations of the retired paper-reading | Upstream install ★ | Upstream install ★ |
  82. | **AI Research skills** | [AI Research](https://github.com/Orchestra-Research/AI-research-SKILLs) | One bundle: tokenization, fine-tuning, post-training, inference, distributed training and optimization; [the same 31 members on both agents](catalog.md#ai-research-members) | 6 native plugins | 6 compatible plugins / source |
  83. | **deepxiv-cli** | [DeepXiv](https://github.com/DeepXiv/deepxiv_sdk) | arXiv / PMC hybrid paper search and reading CLI | Selected source | Selected source |
  84. | **deepxiv-trending-digest** | [DeepXiv](https://github.com/DeepXiv/deepxiv_sdk) | Markdown digests of recently trending papers | Selected source | Selected source |
  85. | **deepxiv-baseline-table** | [DeepXiv](https://github.com/DeepXiv/deepxiv_sdk) | Baseline comparison tables grounded in research papers | Selected source | Selected source |
  86. | **ResearchStudio Idea** | [Microsoft](https://github.com/microsoft/ResearchStudio) | idea_spark, paper_search and scoop_check; complete source, first-use dependencies | Selected source | Selected source |
  87. | **ResearchStudio Reel** | [Microsoft](https://github.com/microsoft/ResearchStudio) | paper2assets, paper2poster, paper2video, paper2blog and paper2reel; independently selected | — | Selected source |
  88. ### MCP Servers
  89. | Item | Source | What It Does | Claude | Codex |
  90. | --- | --- | --- | --- | --- |
  91. | **OpenAI docs** | [OpenAI](https://developers.openai.com/mcp) | Official OpenAI developer documentation | — | MCP ★ |
  92. Complete bundle membership is listed in [catalog.md](catalog.md#members). Selected source revisions and adaptations are in [sources.md](platforms/sources.md). Storage analyzer modifications are documented in [UPSTREAM.md](skills/storage-analyzer/UPSTREAM.md) and submitted as [khazix-skills#50](https://github.com/KKKKhazix/khazix-skills/pull/50). Context7 and Playwright appear under Integrations and are not duplicated as separate MCP choices.
  93. ## Directory Structure
  94. ```text
  95. .
  96. ├── README.md / README.zh-CN.md # User guide and category tables
  97. ├── AGENTS.md / CLAUDE.md # Instructions for working in this repository
  98. ├── INSTALL.md # Agent-guided installation and updates
  99. ├── MAINTAIN.md # Agent workflow for changing this repository
  100. ├── catalog.md # IDs, support, recommendations and routes
  101. ├── skills/ # Author-owned and customized skill sources
  102. ├── platforms/
  103. │ ├── claude/ # Claude instructions, lessons, rules, hooks, skills
  104. │ ├── codex/ # Codex instructions, lessons, settings, skills
  105. │ └── sources.md # External revisions, members and adaptations
  106. ├── scripts/ # Protected file operations and focused helpers
  107. ├── lessons.md # This repository's correction history
  108. ├── docs/ # Showcases, spec and historical migration notes
  109. └── install.sh / install.ps1 # Compatibility notices pointing to INSTALL.md
  110. ```
  111. ## Key Mechanisms
  112. - **Agent-guided choices** — complete numbered lists, explanations and a record of the user's selections. Plugins and MCP servers are managed through the target agent's native tools; custom files use protected copies and partial merges.
  113. - **Independent memory** — Claude uses its own global `lessons.md` plus project `memory/MEMORY.md`; Codex uses its own global `lessons.md` plus project-root `lessons.md`. Templates and real histories remain separate. Only missing global logs are seeded.
  114. - **Rules and status lines** — Claude has one writing rule and independent Python / TypeScript / Go rules; the gradient status line shows model, directory, venv, Git, context and usage. Codex uses its native footer and subagent capabilities; this repository no longer installs custom role presets.
  115. - **Configuration management** — edit-config follows main and records the actual revision. Conflicting source policies require an explicit migration choice; user selections and customizations are preserved. Installation and maintenance need no legacy Claude/Codex branches.
  116. - **Scoped changes** — preserve user edits, credentials, hooks and memory databases. Backups and file ownership support safe updates and explicit removals. ResearchStudio Idea/Reel and PPT Master prepare complete source only; runtime dependencies are handled on first use.
  117. ## Settings Defaults
  118. These are values from the current templates, applied only when the corresponding item is selected. Existing overrides are preserved and differences reported. Base settings, permissions, status lines and lessons are separate choices; Codex's auto-import setting is an installation prerequisite. The agent checks local version support before applying a setting.
  119. | Agent | Key | Template value | Effect |
  120. | --- | --- | --- | --- |
  121. | Claude | `model` / `effortLevel` | `opus` / `xhigh` | Model and reasoning effort |
  122. | Claude | `tui` | `fullscreen` | Fullscreen terminal interface |
  123. | Claude | `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | `1` | Enable the agent-teams experiment |
  124. | Claude | `permissions.defaultMode` | `auto` | Separate permissions template also contains broad tool allowances |
  125. | Codex | `model` / `model_reasoning_effort` | `gpt-5.6-sol` / `max` | Model and reasoning effort |
  126. | Codex | `web_search` | `live` | Live web search |
  127. | Codex | `features.multi_agent` / `concurrent_reasoning_summaries` | `true` / `false` | Agent collaboration and summary behavior |
  128. | Codex | `shell_environment_policy.inherit` | `all` | Inherit the shell environment |
  129. | Codex | `approval_policy` / `sandbox_mode` | `never` / `danger-full-access` | Separately selected high-autonomy permissions |
  130. | Codex | `desktop.external-agent-import-sync-enabled` | `false` | Keep imports under explicit selection control |
  131. Actual settings and per-item operations: [Claude](platforms/claude/README.md#configuration) · [Codex](platforms/codex/README.md#configuration). Current platform validation limits are recorded in [migration notes](docs/migration.md).
  132. ## Customization
  133. You can ask the agent to maintain the repository itself. It follows [MAINTAIN.md](MAINTAIN.md), updates the complete payload and installation route, and keeps the catalogue and both READMEs consistent.
  134. | Request | What the agent changes |
  135. | --- | --- |
  136. | “Add this skill and explain when to use it” | Local source for author-owned skills; upstream installation recipe for third-party originals, with support, category and usage description |
  137. | “Update ResearchStudio” | Recorded upstream revision, members and necessary adaptations, verified in isolation |
  138. | “Edit this skill / remove this option” | Current payload and references; removal records explain old IDs without silently uninstalling user copies |
  139. | “Recommend these skills for Claude / Codex” | Only that agent's author recommendation markers |
  140. | “Add language rules” | `platforms/claude/templates/rules/<lang>/` and its catalogue entry |
  141. | “Change Claude / Codex instructions or lessons policy” | That agent's templates and matching memory rules |
  142. For installed configuration queries and changes, use [edit-config](skills/edit-config/SKILL.md), which follows [INSTALL.md](INSTALL.md) for modifications. The root AGENTS.md, CLAUDE.md and lessons.md belong to this repository; deployable global files live under each platform's templates.
  143. ## Acknowledgements
  144. - [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action) — Anthropic Academy's official course
  145. - [Working for 10 Claude Codes](https://mp.weixin.qq.com/s/9qPD3gXj3HLmrKC64Q6fbQ) by Hu Yuanming — multi-instance patterns
  146. - [Harness Engineering](https://openai.com/index/harness-engineering/) by OpenAI
  147. - [Anthropic Engineering](https://www.anthropic.com/engineering) / [OpenAI Engineering](https://openai.com/news/engineering/)
  148. - [Claude Code Best Practice](https://github.com/shanraisshan/claude-code-best-practice) by shanraisshan
  149. - [Claude How To](https://github.com/luongnv89/claude-howto) by luongnv89
  150. ## License
  151. This repository is MIT. Bundled and fetched third-party components retain their own licenses. **lieflat-charts** uses [PolyForm Noncommercial 1.0.0](https://github.com/larashero3-dotcom/lieflat-charts/blob/main/LICENSE), for noncommercial use only; it is fetched only when selected and is not redistributed here.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.