claude-status
Check collaboration status from Codex side. Use when user says claude status, check status, or collaboration status.
Security Assessment
About claude-status
The Claude Status skill provides a streamlined way to monitor and manage collaboration tasks from the Codex side. It is designed to give users real-time visibility into the state of ongoing or pending tasks handled by Claude, allowing teams to coordinate efficiently without confusion or missed assignments. By centralizing the task status information, this skill helps prevent duplicate work, ensures tasks are picked up in a timely manner, and maintains a clear overview of project workflow within collaborative environments.
The skill's core capabilities include reading the current status of the collaboration environment, which can be 'idle', 'pending', 'working', or 'done'. It automatically identifies the correct `.agent-collab` directory, even if the command is run outside the project root, ensuring reliable access to status files. When a task is pending, the skill can summarize key details from the task request, such as what Claude is asking, the task type, and any essential information required to complete the assignment. It also provides actionable guidance depending on the status, recommending steps like picking up a pending task, continuing work, or notifying the user when Claude has completed a task and awaits acknowledgment.
This skill is particularly useful for developers, project managers, and collaboration-focused teams who interact with Claude through Codex. It supports workflows where multiple users or agents coordinate on tasks and need a transparent view of task progress. Common use cases include monitoring automated task delegation, tracking task completion across team members, and ensuring smooth handoffs between Claude and human users. By simplifying status tracking and providing clear next steps, it enhances productivity and reduces the overhead of managing collaborative projects.
FAQ
How do I check the current collaboration status?
Run the Claude Status skill, which reads the `$AGENT_COLLAB_DIR/status` file and reports whether the environment is idle, pending, working, or done.
What should I do if a task status is 'pending'?
If the status is 'pending', you should run the `/read-task` command to pick up the task. The skill can summarize the task details to help you understand what is required.
Can I run this skill outside the project root?
Yes. The skill resolves the `.agent-collab` directory automatically, even if the command is executed outside the project root, as long as the directory exists somewhere in the parent hierarchy.
What happens if the `.agent-collab` directory is missing?
The skill will stop execution and prompt you to specify the project root, since it requires access to the `.agent-collab` directory to function correctly.
Who is the intended user for this skill?
Developers, project managers, and teams collaborating with Claude through Codex who need to track task status, pending assignments, and workflow progress.
Install claude-status
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
antorsae/dual-agent