Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A tight, operational SKILL.md body: concrete MCP examples, exact configuration, and clear workflows with almost no waste. It falls just short of top marks on actionability and workflow clarity due to a missing checklist example and no error-recovery guidance when post-update verification fails.
Suggestions
Add one example invocation for `add_checklist_to_card` (or drop checklists from the tool list), since checklists are promised in the description and tool summary but never shown.
Extend the post-update verification into a feedback loop: state what to do when the returned card ID/URL is missing or wrong (e.g., re-fetch the card or report the failure) rather than only 'verify before proceeding'.
Clarify or remove the '(ensure proper auth)' aside on the create/update tools line — auth is already fully specified in the MCP Server table, so the aside adds no actionable information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational throughout — MCP server table, compact tool list, JSON invocation examples, a naming block, a transition table, and short session-startup steps. Nothing explains concepts Claude already knows, and no section is padded. | 5 / 5 |
Actionability | Concrete, copy-paste-ready JSON invocations are given for create_card, update_card, and add_comment_to_card, plus exact env vars (TRELLO_API_KEY, TRELLO_TOKEN) and the npx spawn command. Minor gaps: add_checklist_to_card is listed but never exemplified despite checklists being advertised in the description, and "(ensure proper auth)" is vague given auth is already fully specified above. | 4 / 5 |
Workflow Clarity | Session Continuity gives a clear numbered sequence (get_boards → get_lists → get_cards_by_list_id for In Progress) and card transitions are tabulated with explicit 'When' conditions. An explicit checkpoint exists ("After each create/update, verify the returned card ID and URL before proceeding"), but there is no error-recovery loop for what to do when that verification fails, which keeps it below the 5 anchor. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories), so nothing is inlined that belongs elsewhere. The body is a single appropriately-sized overview with well-organized sections and one clearly signaled, one-level-deep pointer to project config (`.opencastle/project/trello-config.md`) for environment-specific IDs. | 5 / 5 |
Total | 18 / 20 Passed |