using-trello

Files (1)

• SKILL.md

SKILL.md (first lines)

# Using Trello Orchestrator

## Prerequisites

This skill suite requires the **Trello MCP Server** to be installed and available to the agent.
- **MCP Server Repository:** [doITmagic/trello-mcp-complete](https://github.com/doITmagic/trello-mcp-complete)

Please ensure the MCP server is configured in your agent's settings before attempting to run any Trello workflows.

## Overview

This is the master router for the Trello MCP workflow. It dictates WHEN to invoke specific Trello skills. Do not attempt to manage Trello directly from this skill; instead, delegate to the sub-skills based on the user's current context.

**Core principle:** Always propose Trello actions proactively, but never execute them without user permission.

**Announce at start:** "I detected an opportunity to use Trello. Using the `using-trello` orchestrator to select the right action."

## The Trello Flow

```dot
digraph trello_flow {
    rankdir=TB;
    "Start" [shape=doublecircle];
    "Is .trello.json configured?" [shape=diamond];
    "Invoke trello-board-initializer" [shape=box];
    "What is the context?" [shape=diamond];

    "Bug/Error Detected" [shape=box];
    "Invoke trello-bug-reporter" [shape=box style=filled fillcolor=lightgreen];

    "New Feature/Plan Created" [shape=box];
    "Invoke trello-task-creator" [shape=box style=filled fillcolor=lightgreen];

    "Task/Bug Completed" [shape=box];
    "Invoke trello-status-updater" [shape=box style=filled fillcolor=lightgreen];

    "Start" -> "Is .trello.json configured?";
    "Is .trello.json configured?" -> "Invoke trello-board-initializer" [label="no"];
    "Is .trello.json configured?" -> "What is the context?" [label="yes"];
    "Invoke trello-board-initializer" -> "What is the context?";

    "What is the context?" -> "Bug/Error Detected";
    "Bug/Error Detected" -> "Invoke trello-bug-reporter";

    "What is the context?" -> "New Feature/Plan Created";
    "New Feature/Plan Created" -> "Invoke trello-task-creator";

    "What is the context?" -> "Task/Bug Completed";
    "Task/Bug Completed" -> "Invoke trello-status-updater";
}
```

## Mandatory Routing Rules

When you detect one of the contexts below, you MUST invoke the corresponding sub-skill:

1. **Board Setup:** If this is the first time Trello is mentioned in the project, or if `.trello.json` is missing:
   - **REQUIRED SUB-SKILL:** Use `trello-board-initializer`

2. **Bugs & Errors:** If a test fails, an exception is thrown, or the user reports unexpected behavior:
   - **REQUIRED SUB-SKILL:** Use `trello-bug-reporter`

3. **Planning & Ideas:** If the user says "we should build X", "here is my plan", or after generating an implementation plan:
   - **REQUIRED SUB-SKILL:** Use `trello-task-creator`

4. **Completion:** If tests pass, a PR is ready, or a bug is confirmed fixed (after verification):
   - **REQUIRED SUB-SKILL:** Use `trello-status-updater`

## Red Flags

- Never attempt to create or move cards directly from this skill. Always dispatch the specific sub-skill.
- Never spam the user. Ask ONE polite question proposing the Trello action.
- Always wait for user approval before creating or modifying any Trello cards.

From doITmagic/ai-agent-skills, MIT.

More from doITmagic/ai-agent-skills