trello-integration-skill
This skill allows you to interact with Trello account to list boards, view lists, and create cards automatically.
Skill files
---name: trello-integration-skilldescription: This skill allows you to interact with Trello account to list boards, view lists, and create cards automatically.---# Trello Integration SkillThe 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.## Features- **Fetch Boards**: Retrieve a list of all Trello boards the user has access to, including their Name, ID, and URL.- **Fetch Lists**: Retrieve all lists (columns like "To Do", "In Progress", "Done") belonging to a specific board.- **Create Cards**: Automatically create new cards with titles and descriptions in designated lists.---## Setup & PrerequisitesTo use this skill locally, you need to provide your Trello Developer API credentials.1. Generate your credentials at the [Trello Developer Portal (Power-Ups Admin)](https://trello.com/app-key).2. Create an API Key.3. Generate a Secret Token (Read/Write access).4. Add these credentials to the project's root `.env` file:```env# Trello IntegrationTRELLO_API_KEY=your_api_key_hereTRELLO_TOKEN=your_token_here```---## Usage & ArchitectureThe skill utilizes standalone Node.js scripts located in the `.agent/skills/trello_skill/scripts/` directory.### 1. List All BoardsFetches all boards for the authenticated user to determine the correct target `boardId`.**Execution:**```bashnode .agent/skills/trello_skill/scripts/list_boards.js```### 2. List Columns (Lists) in a BoardFetches the lists inside a specific board to find the exact `listId` (e.g., retrieving the ID for the "To Do" column).**Execution:**```bashnode .agent/skills/trello_skill/scripts/list_lists.js <boardId>```### 3. Create a New CardPushes a new card to the specified list. **Execution:**```bashnode .agent/skills/trello_skill/scripts/create_card.js <listId> "<Card Title>" "<Optional Description>"```*(Always wrap the card title and description in double quotes to prevent bash argument splitting).*---## AI Agent WorkflowWhen the user requests to manage or add a task to Trello, follow these steps autonomously: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").2. **Execute Command**: Run the `create_card.js <listId> "Task Title" "Task Description"` script.3. **Report Back**: Confirm the successful creation with the user and provide the direct URL to the newly created Trello card.Prompts come from prompts.chat, an open community library dedicated to the public domain (CC0). We refresh our copy every week.