An MCP server implementation for the Clark AI Coworker skill that assigns tasks with execution planning and estimated duration tracking
The server exposes a single tool 'assign_task' with major quality gaps. The tool definition is visible in client.py but lacks critical elements: the description (82 chars) is present but vague and lacks actionable guidance for LLM selection; parameters have minimal description ('The task description' and 'The desired format'); no output schema is documented; no error handling or recovery guidance; no input validation or constraints (e.g., task length limits, format enum); the implementation is entirely mock/local and does not actually execute tasks. The tool name 'assign_task' is verb-noun styled correctly, but the description does not explain WHEN to use this vs other task-handling patterns, what the actual execution plan represents, or how deliverable_format influences behavior. No examples of valid format values provided (should be enum). The parameters lack type constraints and detailed descriptions per the 72-char baseline. Output is undocumented, the response includes 'plan', 'estimated_duration_min', and 'coworker_id', but there is no specification of these fields' types, semantics, or guarantees. The mock implementation generates trivial placeholder data (parsing task by word count, fabricating step labels) with no actual task execution capability.
Assigns a task to the Clark AI coworker with a detailed execution plan and estimated duration
No documented output schema. The tool returns 'plan', 'estimated_duration_min', and 'coworker_id', but these fields are undocumented, no types, formats, or semantics. LLMs cannot reliably extract or chain output.
Parameter 'deliverable_format' lacks constraints. Should define an enum of valid values (e.g., 'Markdown Report', 'JSON', 'PDF', 'Email') rather than free-form string. Current description does not list valid options.
Tool description (82 chars) does not explain WHEN to use this tool vs alternatives, what the 'execution plan' field represents, or whether the tool actually executes tasks or merely plans them. Current description: 'Assigns a task to the Clark AI coworker with a detailed execution plan and estimated duration' is vague and does not guide LLM selection.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | 2026-07-28+ | v2 |
Parameter descriptions are minimal (3 - 6 words). 'The task description to be assigned' lacks detail: does it accept free text, structured YAML, or a specific schema? What is the max length? Does it support attachments?
No error handling or recovery guidance. The mock implementation always succeeds. Real deployments should document failure modes (task too large, invalid format, coworker unavailable) and suggest next steps (retry, reformulate, check status).
Mock implementation with no real capability. The tool fabricates plan steps ('Analyze task scope', 'Gather data', etc.) based on task word count and does not actually execute anything. This is a demonstration stub, not a production tool. Agents cannot trust the 'estimated_duration_min' or 'plan' for real work.