@apilium/trello

Trello integration skill for Mayros -- boards, lists, cards via REST API.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/trello ~/.mayros/skills/trello

Or install via the Mayros CLI:

mayros skill install @apilium/trello

Configuration

Set the following environment variables:

| Variable | Description | Example | |----------|-------------|---------| | TRELLO_API_KEY | Trello API key | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | TRELLO_TOKEN | Trello API token | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx... |

Obtaining credentials

1. Go to https://trello.com/power-ups/admin
2. Create a new Power-Up or use an existing one
3. Generate an API key
4. Generate a token by visiting the token authorization URL

Usage

Once configured, the agent can:

• List boards: View all accessible boards
• Manage lists: Create, archive, and organize lists
• Manage cards: Create, update, move, and delete cards
• Checklists: Add checklists and checklist items to cards
• Labels: Create and assign labels for organization
• Due dates: Set and track deadlines with completion status

Example prompts

"Show me all my Trello boards"
"Create a card 'Fix login bug' in the 'To Do' list on the Dev board"
"Move the 'Deploy v2' card to 'Done'"
"What cards are overdue on the Project board?"
"Add a checklist to the 'Release Prep' card"

Semantic Predicates

| Predicate | Scope | Description | |-----------|-------|-------------| | trello:card_created | agent | Cards created by the agent | | trello:card_moved | agent | Cards moved between lists | | trello:board_context | agent | Board summary for context enrichment |

Due Date Annotations

The skill annotates card query results with due date status:

• overdue -- Due date has passed and card is not complete
• due-soon -- Due within the next 48 hours
• on-track -- Due date is in the future (beyond 48 hours)
• completed -- Card is marked as complete

License

MIT