| name | codex-read |
| description | Read and integrate response from Codex. Use when user says codex read, get codex response, or check codex results. |
Codex Read Skill
Read the response from Codex and integrate findings.
Steps
Before any file operations, resolve the .agent-collab directory so commands work outside the project root:
AGENT_COLLAB_DIR="${AGENT_COLLAB_DIR:-}"
if [ -n "$AGENT_COLLAB_DIR" ]; then
if [ -d "$AGENT_COLLAB_DIR/.agent-collab" ]; then
AGENT_COLLAB_DIR="$AGENT_COLLAB_DIR/.agent-collab"
elif [ ! -d "$AGENT_COLLAB_DIR" ]; then
AGENT_COLLAB_DIR=""
fi
fi
if [ -z "$AGENT_COLLAB_DIR" ]; then
AGENT_COLLAB_DIR="$(pwd)"
while [ "$AGENT_COLLAB_DIR" != "/" ] && [ ! -d "$AGENT_COLLAB_DIR/.agent-collab" ]; do
AGENT_COLLAB_DIR="$(dirname "$AGENT_COLLAB_DIR")"
done
AGENT_COLLAB_DIR="$AGENT_COLLAB_DIR/.agent-collab"
fi
If $AGENT_COLLAB_DIR does not exist, stop and ask for the project root.
1. Check Status
Read $AGENT_COLLAB_DIR/status:
idle: No pending task. Inform user.pending: Codex hasn't started. Check Codex pane.working: Codex still processing. Wait.done: Proceed to read response.
2. Read Response
Read $AGENT_COLLAB_DIR/responses/response.md and parse:
- Task type completed
- Findings/output
- Any code produced
- Recommendations
3. Present to User
Summarize clearly based on task type:
For CODE_REVIEW:
- Bugs/issues with severity
- Security concerns
- Performance issues
- Suggested improvements
For IMPLEMENT:
- What was implemented
- Approach taken
- Integration instructions
For PLAN_REVIEW:
- Critique summary
- Identified risks
- Alternative suggestions
4. Integrate (if applicable)
For implementations:
- Ask if user wants to integrate
- Apply changes if yes
- Run relevant tests
5. Reset Status
Write idle to $AGENT_COLLAB_DIR/status
6. Next Steps
Suggest appropriate follow-up:
- Reviews: Address issues found
- Implementations: Test and validate
- Plan reviews: Iterate on plan
