How am-will/codex-skills works
CodexSkills is a repository of reusable agent skills, custom Codex agent definitions, and installable hook bundles, with a small CLI for copying skills from Git repositories. A user selects a capability, installs it into an agent or project, then uses its instructions or configuration; hooks are separately installed into a project. The llm-council skill adds a multi-provider planning workflow with a live review UI. Evidence for broad catalog relationships comes from the README; source excerpts additionally establish the council UI/state links. Other skill internals are not sampled.
Main entry points: llm_council.py Council Runner · ui_server.py Review UI Server · install-bundle.py Bundle Installer · skills Skill Collection
Components 17
Skill Catalog
- Skill Collection
skills - Planning Skills
skills/planner - Documentation Access
skills/read-github - Frontend Guidance
skills/frontend-design - Browser Automation
skills/gemini-computer-use
Planning Orchestration
- Council Runner
skills/llm-council/scripts/llm_council.py - Review UI Server
skills/llm-council/scripts/ui_server.py - UI State
skills/llm-council/scripts/ui_state.py - Review UI
skills/llm-council/scripts/ui/app.js
Agent Configurations
- Specialist Agents
agents
Hook Bundles
- Hook Catalog
hooks/aitmpl-codex - Bundle Installer
hooks/aitmpl-codex/install-bundle.py
Other components
- User
- Skills CLI
- AI Providers
- Project Hook Config
- Skills Installer
Connections 17
- User → Skills Installer: selects skills
README.md - Skills Installer → Skill Collection: installs from
README.md - User → Skills CLI: runs CLI
- Skills CLI → Skill Collection: copies skills
- User → Planning Skills: uses planning
README.md - User → Documentation Access: uses docs tools
README.md - User → Frontend Guidance: uses guidance
README.md - User → Browser Automation: runs browser agent
README.md - User → Council Runner: starts planning
README.md - Council Runner → AI Providers: requests plans
README.md - Council Runner → Review UI Server: starts UI server
skills/llm-council/scripts/llm_council.py - Review UI Server → UI State: reads UI state
skills/llm-council/scripts/ui_server.py - Review UI → Review UI Server: fetches and posts
README.md - User → Specialist Agents: configures agents
README.md - User → Hook Catalog: chooses bundle
README.md - User → Bundle Installer: installs bundle
README.md - Bundle Installer → Project Hook Config: merges configuration
hooks/aitmpl-codex/install-bundle.py