{
  "markdown": "<img width=\"750\" height=\"491\" alt=\"image\" src=\"https://github.com/user-attachments/assets/c244cbdd-6f98-40b5-81f0-754aad546be4\" />\n\n\n# CodexSkills\n\nA collection of Codex/agent skills for planning, documentation access, frontend development, and browser automation.\n\n## Available skills\n\n### Agent Orchestration\n\n- `planner`:\n  Create comprehensive, phased implementation plans with sprints and atomic tasks. Use for planning implementations, breaking down features, or creating structured roadmaps.\n- `plan-harder`:\n  Enhanced planning variant for more detailed analysis and task breakdown.\n- `parallel-task`:\n  Execute plan files by launching multiple parallel subagents to complete tasks simultaneously. Requires an existing plan file from `planner`.\n- `llm-council`:\n  Multi-agent orchestration system for planning complex tasks. Spawns multiple AI planners (Claude, Codex, Gemini) to generate independent plans, then uses a judge agent to synthesize the best approach. Includes a real-time web UI for monitoring progress and refining plans interactively.\n\n### Documentation Access\n\n- `ctx7old`:\n  Fetch up-to-date library documentation via Context7 CLI.\n- `openai-docs-skill`:\n  Query OpenAI developer docs via the OpenAI Docs MCP server using CLI.\n- `markdown-url`:\n  Prefix any website you need to visit with `https://markdown.new/` for a clean, Markdown-friendly view.\n- `read-github`:\n  Read and search GitHub repository documentation via gitmcp.io MCP service. Converts `github.com/owner/repo` URLs to `gitmcp.io/owner/repo` for LLM-friendly access to repos.\n\n### Prompting\n\n- `gpt-5-6-prompt-builder`:\n  Build, transform, audit, and migrate prompts for GPT-5.6 Sol. It gathers missing behavior-critical requirements with `request_user_input` when available, then produces an outcome-first prompt with explicit success criteria, guardrails, tools, approvals, validation, and stop rules.\n\n### Frontend & Design\n\n- `frontend-design`:\n  Distinctive frontend design system guidance (imported from Anthropic).\n- `frontend-responsive-ui`:\n  Responsive UI standards (imported from Anthropic).\n- `vercel-react-best-practices`:\n  React/Next.js performance guidance (imported from Vercel).\n\n### Codex Tooling\n\n- `create-hook`:\n  Create or update Codex hooks for global or project scope. Guides users through scope, hook type, and behavior, then writes hook config and scripts.\n- `pluginstaller`:\n  Install a Codex plugin from a GitHub repo into a repo or personal marketplace. Handles plugin discovery, validation, and marketplace registration.\n- `role-creator`:\n  Create and update custom Codex agents as standalone TOML files. Collects required inputs and writes agent definitions to global or project scope.\n\n### Browser Automation\n\n- `gemini-computer-use`:\n  Gemini 2.5 Computer Use browser-control agent skill (Playwright + safety confirmation loop).\n- `agent-browser`:\n  Fast Rust-based headless browser automation CLI from Vercel Labs with snapshot/act pattern for AI agents.\n\n## Installation\n\nInstall skills using the [skills.sh](https://skills.sh) CLI:\n\n```bash\n# List available skills before installing\nnpx skills add am-will/codex-skills --list\n\n# Install specific skills to user scope (global)\nnpx skills add am-will/codex-skills --skill planner --skill context7 -g\n\n# Install all skills interactively (prompts for selection)\nnpx skills add am-will/codex-skills -g\n\n# Install to specific agents\nnpx skills add am-will/codex-skills --skill planner -a claude-code -a codex -g\n\n# Install to current project (instead of global)\nnpx skills add am-will/codex-skills --skill planner\n\n# Non-interactive install (skip prompts)\nnpx skills add am-will/codex-skills --skill planner -g -y\n```\n\n**CLI Options:**\n| Flag | Purpose |\n|------|---------|\n| `-g, --global` | Install to user directory (global for all projects) |\n| `-a, --agent <agents...>` | Target specific agents (`claude-code`, `codex`, etc.) |\n| `-s, --skill <skills...>` | Install specific skills by name |\n| `-l, --list` | List available skills without installing |\n| `-y, --yes` | Skip confirmation prompts |\n\n**Other commands:**\n```bash\nnpx skills list          # Show installed skills\nnpx skills remove <name> # Uninstall a skill\nnpx skills update        # Update all installed skills\n```\n\n**Note on Browser Tools**: The repo includes two browser automation tools (`gemini-computer-use` and `agent-browser`). You don't need to install both - choose the one that best fits your workflow. I recommend agent-browser for speed and simplicity.\n\n**Note on Context7**: The `ctx7old` skill requires a Context7 API key in `CONTEXT7_API_KEY`. See `skills/ctx7old/.env.example` for setup.\n\n**Note on Gemini Computer Use Skill**: This skill requires a GEMINI_API_KEY. Ask Codex to help you set it up.\n\n**Note on llm-council**: This skill requires API keys or Active Subscriptions for multiple providers (Claude/Anthropic, OpenAI for Codex, Google for Gemini). Run `./setup.sh` in the skill directory to configure. Includes a real-time web UI that auto-launches during planning sessions.\n\n---\n\n### Codex Hook Catalog\n\nThe `hooks/` directory contains a catalog of **51 ready-to-install Codex hook bundles**, generated from an upstream hook template set and adapted for the current Codex event model. The active catalog now includes the former file-edit bundles that became viable once Codex started emitting `apply_patch` hook events with `Edit` and `Write` matcher compatibility.\n\n**Categories:**\n\n| Category | Bundles | Examples |\n|---|---|---|\n| `automation` | 18 | Slack/Discord/Telegram notifications, deployment health monitor, AGENTS loader, build/dependency automation |\n| `development-tools` | 8 | Command logger, debug window, worktree ghostty, file backup, lint/format helpers |\n| `git` | 3 | Conventional commits, prevent direct push, validate branch name |\n| `git-workflow` | 2 | Auto git add, smart commit |\n| `monitoring` | 2 | Desktop notification on stop, LangSmith tracing |\n| `performance` | 2 | Performance monitor, performance budget guard |\n| `post-tool` | 4 | Format JS/Python, git add changes, run tests after changes |\n| `pre-tool` | 4 | Notify before bash, update search year, backup before edit, console log cleaner |\n| `quality-gates` | 3 | Scope guard, plan gate, TDD gate |\n| `security` | 4 | Dangerous command blocker, secret scanner, file protection, security scanner |\n| `testing` | 1 | Test runner |\n\n**Install a bundle:**\n```bash\npython3 hooks/aitmpl-codex/install-bundle.py hooks/aitmpl-codex/<category>/<bundle> <target-repo>\n```\n\n**Manual install:** Copy the bundle's `hooks.json` into `<repo>/.codex/hooks.json` and its `.codex/hooks/` scripts into `<repo>/.codex/hooks/`, then restart Codex.\n\nSee [`hooks/README.md`](hooks/README.md) for full details on compatibility, testing harness, and bundle structure.\n\n---\n\n### Custom Multi-Agents for Codex\n\nThe `agents/` directory contains custom multi-agent configurations for Codex. These TOML-based agent definitions provide specialized roles (architect, frontend, backend, security, etc.) and worker tiers for parallel task execution. Use them with Codex to spin up purpose-built agents tailored to your workflow.\n",
  "bytes": 7153,
  "sha": "85c3c537613e33040af26a7672d51086729580890e0a451343d3d96b38182e41",
  "repo_slug": "am-will/codex-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_am_will_codex_skills_frontend_responsive_9f0d4402/readme"
}