English | 中文 | Changelog
Awesome Agent Config
One repository for Claude Code and 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.
Showcase
Quick Start
The active release line is Mizoreww/awesome-agent-config on main. Upgrading from the previous repository name or development branch? Follow the v4 migration notes.
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: 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 records exact routes and limitations; official availability depends on the account and client. Existing equivalent capabilities are reused.
Installation workflow · Claude operations · Codex operations · Full catalogue and bundle members
Catalogue
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.
Core
| Item | Source | What It Does | Claude | Codex |
|---|
| CLAUDE.md / AGENTS.md | Repository | Separate global instructions for each agent | Template ★ | Template ★ |
| Base settings | Repository | Partially merge model, reasoning and runtime settings | Template ★ | Template ★ |
| Permissions | Repository | Optional high-autonomy permissions for a user-selected trusted environment | Template ★ | Template ★ |
| Writing style rule | Repository | Complete English writing requirements and examples; replaces the previous common rules | Rule ★ | — |
| StatusLine | Repository | Claude gradient context/usage bar and fonts; Codex native footer | Template ★ | Template ★ |
| Lessons | Repository | Independent blank global logs and memory routing; preserve real corrections | Template ★ | Template ★ |
Language Rules
| Item | Source | What It Does | Claude | Codex |
|---|
| Python rules | Repository | PEP 8, pytest, type hints and bandit | Template | — |
| TypeScript rules | Repository | Zod, Playwright and immutability | Template | — |
| Go rules | Repository | gofmt, table-driven tests and gosec | Template | — |
Review
| Item | Source | What It Does | Claude | Codex |
|---|
| Claude code-review | Anthropic | Confidence-based pull request review | Native plugin ★ | — |
| Matt code-review | Matt Pocock | Separate Standards and Spec reviews; a standalone choice on Codex | In Matt bundle | Selected source ★ |
| adversarial-review | poteto/noodle | Cross-model review through Skeptic, Architect and Minimalist lenses | Bundled skill ★ | — |
| codex-in-claude | OpenAI | Call Codex CLI from Claude; choose alongside review tools according to need | Native plugin | — |
Workflow
| Item | Source | What It Does | Claude | Codex |
|---|
| andrej-karpathy-skills | Karpathy skills | Think before coding, keep changes focused, define verifiable outcomes | Native plugin ★ | Plugin / source ★ |
| superpowers | obra / OpenAI curated | Brainstorming, debugging, TDD, worktrees and planning; 14-skill bundle | Native plugin | Plugin / source |
| mattpocock-skills | Matt Pocock | Planning, TDD, research, grilling and delivery; Claude full package, Codex 20 selected v1.1.0 skills, including handoff | Native plugin ★ | Selected source ★ |
| neat-freak | khazix-skills | Reconcile project docs, agent rules, authorized memory and workspace residue | Upstream install ★ | Upstream install ★ |
| code-simplifier | Anthropic | Code simplification and refactoring agent | Native plugin ★ | — |
| edit-config | Repository | Inspect and manage configuration on main; shared by both agents | Bundled skill ★ | Bundled skill ★ |
Integrations
| Item | Source | What It Does | Claude | Codex |
|---|
| context7 | Upstash | Up-to-date library documentation lookup | Native plugin ★ | Plugin / MCP ★ |
| playwright | Microsoft | Browser automation, E2E testing and screenshots; Codex MCP pinned to 0.0.78 | Native plugin ★ | MCP ★ |
Design & Content
| Item | Source | What It Does | Claude | Codex |
|---|
| document-skills | Anthropic | PDF, DOCX, PPTX and XLSX creation and editing; reuse equivalent built-in Codex tools | Native plugin ★ | Built-in / compatible plugin / source ★ |
| example-skills | Anthropic | Claude: 12 examples; Codex: canvas-design, algorithmic-art and mcp-builder | Native plugin ★ | Selected source ★ |
| frontend-design | Anthropic | Distinctive frontend interfaces; reused when already supplied by the examples bundle | Native plugin ★ | Plugin / source ★ |
| humanizer | blader | Remove mechanical AI writing patterns in English | Plugin / source ★ | Upstream install ★ |
| humanizer-zh | op7418 | Remove mechanical AI writing patterns in Chinese | Upstream install | Upstream install |
| lieflat-charts | lieflat-charts | Lupi / Basics / Glance / Maps HTML galleries and 12 bilingual report templates; source excludes preview media; noncommercial use only | Selected source | — |
Slides
| Item | Source | What It Does | Claude | Codex |
|---|
| frontend-slides | zarazhangrui | Zero-dependency HTML slide generation with PPT conversion and varied styles | Native plugin | Compatible plugin / source |
| ppt-master | hugohe3 | Editable PPTX from PDF / DOCX / URL / Markdown, with shapes and animations; runtime setup on first use | Native plugin | Selected source |
Memory & Lifestyle
| Item | Source | What It Does | Claude | Codex |
|---|
| claude-health | tw93 | Health and wellness dashboard for Claude sessions | Native plugin | — |
Storage
| Item | Source | What It Does | Claude | Codex |
|---|
| storage-analyzer | khazix-skills (modified) | Read-only disk analysis and an interactive HTML report with guarded cleanup; includes Linux support and security fixes | Bundled skill | Bundled skill |
Academic Research
| Item | Source | What It Does | Claude | Codex |
|---|
| asd-ste100 | 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 ★ |
| AI Research skills | AI Research | One bundle: tokenization, fine-tuning, post-training, inference, distributed training and optimization; the same 31 members on both agents | 6 native plugins | 6 compatible plugins / source |
| deepxiv-cli | DeepXiv | arXiv / PMC hybrid paper search and reading CLI | Selected source | Selected source |
| deepxiv-trending-digest | DeepXiv | Markdown digests of recently trending papers | Selected source | Selected source |
| deepxiv-baseline-table | DeepXiv | Baseline comparison tables grounded in research papers | Selected source | Selected source |
| ResearchStudio Idea | Microsoft | idea_spark, paper_search and scoop_check; complete source, first-use dependencies | Selected source | Selected source |
| ResearchStudio Reel | Microsoft |
MCP Servers
| Item | Source | What It Does | Claude | Codex |
|---|
| OpenAI docs | OpenAI | Official OpenAI developer documentation | — | MCP ★ |
Complete bundle membership is listed in catalog.md. Selected source revisions and adaptations are in sources.md. Storage analyzer modifications are documented in UPSTREAM.md and submitted as khazix-skills#50. Context7 and Playwright appear under Integrations and are not duplicated as separate MCP choices.
Directory Structure
.
├── README.md / README.zh-CN.md # User guide and category tables
├── AGENTS.md / CLAUDE.md # Instructions for working in this repository
├── INSTALL.md # Agent-guided installation and updates
├── MAINTAIN.md # Agent workflow for changing this repository
├── catalog.md # IDs, support, recommendations and routes
├── skills/ # Author-owned and customized skill sources
├── platforms/
│ ├── claude/ # Claude instructions, lessons, rules, hooks, skills
│ ├── codex/ # Codex instructions, lessons, settings, skills
│ └── sources.md # External revisions, members and adaptations
├── scripts/ # Protected file operations and focused helpers
├── lessons.md # This repository's correction history
├── docs/ # Showcases, spec and historical migration notes
└── install.sh / install.ps1 # Compatibility notices pointing to INSTALL.md
Key Mechanisms
- 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.
- 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.
- 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.
- 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.
- 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.
Settings Defaults
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.
| Agent | Key | Template value | Effect |
|---|
| Claude | model / effortLevel | opus / xhigh | Model and reasoning effort |
| Claude | tui | fullscreen | Fullscreen terminal interface |
| Claude | env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | 1 | Enable the agent-teams experiment |
| Claude | permissions.defaultMode | auto | Separate permissions template also contains broad tool allowances |
| Codex | model / model_reasoning_effort | gpt-5.6-sol / max | Model and reasoning effort |
| Codex | web_search | live | Live web search |
| Codex | features.multi_agent / concurrent_reasoning_summaries | true / false | Agent collaboration and summary behavior |
| Codex | shell_environment_policy.inherit | all | Inherit the shell environment |
| Codex | approval_policy / sandbox_mode | never / danger-full-access | Separately selected high-autonomy permissions |
| Codex | desktop.external-agent-import-sync-enabled | false | Keep imports under explicit selection control |
Actual settings and per-item operations: Claude · Codex. Current platform validation limits are recorded in migration notes.
Customization
You can ask the agent to maintain the repository itself. It follows MAINTAIN.md, updates the complete payload and installation route, and keeps the catalogue and both READMEs consistent.
| Request | What the agent changes |
|---|
| “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 |
| “Update ResearchStudio” | Recorded upstream revision, members and necessary adaptations, verified in isolation |
| “Edit this skill / remove this option” | Current payload and references; removal records explain old IDs without silently uninstalling user copies |
| “Recommend these skills for Claude / Codex” | Only that agent's author recommendation markers |
| “Add language rules” | platforms/claude/templates/rules/<lang>/ and its catalogue entry |
| “Change Claude / Codex instructions or lessons policy” | That agent's templates and matching memory rules |
For installed configuration queries and changes, use edit-config, which follows 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.
Acknowledgements
License
This repository is MIT. Bundled and fetched third-party components retain their own licenses. lieflat-charts uses PolyForm Noncommercial 1.0.0, for noncommercial use only; it is fetched only when selected and is not redistributed here.
