codex-qa
Codex Q&A
Use OpenAI's Codex CLI to answer questions about the codebase.
Prerequisites
Codex CLI must be installed and configured:
npm install -g @openai/codex
# or
brew install --cask codex
An OpenAI API key must be configured (OPENAI_API_KEY environment variable or via codex initial setup).
Usage
Spawn the codex-qa subagent to handle the question:
Use the Task tool to spawn the codex-qa agent with the user's question.
The subagent will:
- Formulate a clear prompt for Codex
- Run
codex exec "question"in read-only mode - Return Codex's response
Direct Usage (without subagent)
If you prefer to run Codex directly:
codex exec "your question here"
Command Options
- Basic query:
codex exec "question" - With image:
codex -i image.png exec "question about image" - JSON output:
codex exec --json "question" - Longer timeout:
codex exec --timeout 300000 "complex question"
Common Use Cases
- Code explanation: "What does this function do?"
- Architecture questions: "How is the database layer structured?"
- Finding patterns: "Where is error handling implemented?"
- Code review: "Review this file for potential issues"
- Comparison: Get a second opinion on a code question
Notes
- Codex exec runs in read-only mode by default - it cannot modify files
- Activity streams to stderr, final answer goes to stdout
- For complex questions, use the subagent for better context isolation
More from funnelenvy/agents_webinar_demos
bq-query-optimization
Use when writing BigQuery queries, optimizing query performance, analyzing execution plans, or avoiding common SQL gotchas. Covers parameterized queries, UDFs, scripting, window functions (QUALIFY, ROW_NUMBER, RANK, LEAD/LAG), JSON functions, ARRAY/STRUCT operations, BigQuery-specific features (EXCEPT, REPLACE, SAFE_*), CTE re-execution issues, NOT IN with NULLs, DML performance, Standard vs Legacy SQL, and performance best practices.
29gemini-qa
Use Google Gemini CLI to answer questions about code, analyze files, or perform codebase exploration. Invoke this skill when the user asks to use Gemini, wants a second opinion from another AI, or wants to compare Claude's answer with Gemini's response.
25n8n-workflow
Use when creating, deploying, or managing N8N workflows. Automatically uses N8N_HOST and N8N_API_KEY from environment.
22playwright-browser
Use when capturing screenshots, automating browser interactions, or scraping web content. Covers Playwright Python API for page navigation, screenshots, element selection, form filling, and waiting strategies.
21hubspot-crm
Use when syncing contacts or lists to HubSpot CRM. Automatically uses HUBSPOT_API_TOKEN from environment.
20gcp-cli-gotchas
Use when encountering gcloud or bq CLI formatting errors, quote escaping issues, command substitution problems, or when debugging CLI commands. Provides solutions for backtick usage, heredoc syntax, timestamp filters, parameter escaping, and multiline command formatting.
12