1
---
2
name: trello-integration-skill
3
description: This skill allows you to interact with Trello account to list boards, view lists, and create cards automatically.
4
---
5
6
# Trello Integration Skill
7
8
The Trello Integration Skill provides a seamless connection between the AI agent and the user's Trello account. It empowers the agent to autonomously fetch existing boards and lists, and create new task cards on specific boards based on user prompts.
9
10
## Features
11
- **Fetch Boards**: Retrieve a list of all Trello boards the user has access to, including their Name, ID, and URL.
12
- **Fetch Lists**: Retrieve all lists (columns like "To Do", "In Progress", "Done") belonging to a specific board.
13
- **Create Cards**: Automatically create new cards with titles and descriptions in designated lists.
14
15
---
16
17
## Setup & Prerequisites
18
19
To use this skill locally, you need to provide your Trello Developer API credentials.
20
21
1. Generate your credentials at the [Trello Developer Portal (Power-Ups Admin)](https://trello.com/app-key).
22
2. Create an API Key.
23
3. Generate a Secret Token (Read/Write access).
24
4. Add these credentials to the project's root `.env` file:
25
26
```env
27
# Trello Integration
28
TRELLO_API_KEY=your_api_key_here
29
TRELLO_TOKEN=your_token_here
30
```
31
32
---
33
34
## Usage & Architecture
35
36
The skill utilizes standalone Node.js scripts located in the `.agent/skills/trello_skill/scripts/` directory.
37
38
### 1. List All Boards
39
Fetches all boards for the authenticated user to determine the correct target `boardId`.
40
41
**Execution:**
42
```bash
43
node .agent/skills/trello_skill/scripts/list_boards.js
44
```
45
46
### 2. List Columns (Lists) in a Board
47
Fetches the lists inside a specific board to find the exact `listId` (e.g., retrieving the ID for the "To Do" column).
48
49
**Execution:**
50
```bash
51
node .agent/skills/trello_skill/scripts/list_lists.js <boardId>
52
```
53
54
### 3. Create a New Card
55
Pushes a new card to the specified list.
56
57
**Execution:**
58
```bash
59
node .agent/skills/trello_skill/scripts/create_card.js <listId> "<Card Title>" "<Optional Description>"
60
```
61
*(Always wrap the card title and description in double quotes to prevent bash argument splitting).*
62
63
---
64
65
## AI Agent Workflow
66
67
When the user requests to manage or add a task to Trello, follow these steps autonomously:
68
1. **Identify the Target**: If the target `listId` is unknown, first run `list_boards.js` to identify the correct `boardId`, then execute `list_lists.js <boardId>` to retrieve the corresponding `listId` (e.g., for "To Do").
69
2. **Execute Command**: Run the `create_card.js <listId> "Task Title" "Task Description"` script.
70
3. **Report Back**: Confirm the successful creation with the user and provide the direct URL to the newly created Trello card.
71