# Trello > Manage Trello boards, lists, and cards. Trigger on phrases like "trello", "my boards", "shopping list", "create card", "move card", "sort cards". - **Type:** Skill - **Install:** `agentstack add skill-dbhq-uk-trello-skill-trello` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [dbhq-uk](https://agentstack.voostack.com/s/dbhq-uk) - **Installs:** 0 - **Category:** [Productivity](https://agentstack.voostack.com/c/productivity) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [dbhq-uk](https://github.com/dbhq-uk) - **Source:** https://github.com/dbhq-uk/trello-skill/tree/main/skills/trello - **Website:** https://dbhq.uk ## Install ```sh agentstack add skill-dbhq-uk-trello-skill-trello ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Trello Board Management Manage Trello boards, lists, and cards via the Trello REST API. ## Core convention - ALWAYS categorise every card **Every card must carry a category label. No exceptions.** Whenever you create a card, sort/order, or "organise / align" a board, ensure EVERY card on the affected list(s) has a label - not just the top few you reordered. "Order the backlog" or "align with the roadmap" means **categorise the whole list**, then order it - never leave a flat, unlabelled tail. - Read the board's existing labels first (`GET /1/boards/{boardId}/labels`); reuse them, don't invent a parallel taxonomy. Typical set: Business, Feature, Pipeline, DevOps/Infra, Data, UI/UX, Bug/Fix. - `trello-cards.sh` reads **and** writes labels: `labels` to show them, `label-add ` and `label-remove` to change them. Label IDs come from `trello-boards.sh labels `. Credentials stay inside the script, so no key or token reaches the command line. - When you create a card, label it in the same pass. - After any board-org task, verify zero unlabelled cards remain on the lists you touched. ## Prerequisites - Credentials configured in `~/.trello/` (run setup if not done) - jq, curl installed ## Setup If not configured, run: ```bash ${CLAUDE_SKILL_DIR}/scripts/trello-setup.sh ``` ## Board & List Operations ```bash # List all boards ${CLAUDE_SKILL_DIR}/scripts/trello-boards.sh boards # Find board by name ${CLAUDE_SKILL_DIR}/scripts/trello-boards.sh find "Shopping" # Get board details ${CLAUDE_SKILL_DIR}/scripts/trello-boards.sh board # List all lists in a board ${CLAUDE_SKILL_DIR}/scripts/trello-boards.sh lists # Get list details ${CLAUDE_SKILL_DIR}/scripts/trello-boards.sh list ``` ## Card Operations ### Listing Cards ```bash # List cards in a list ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh list # List more cards ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh list 100 # Get JSON output (for scripting/sorting) ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh list-json # Read full card details ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh read ``` ### Creating & Updating Cards ```bash # Create a card ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh create "Card title" "Optional description" # Update card field (name, desc, due, closed) ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh update name "New title" # Move card to another list ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh move ``` ### Positioning Cards ```bash # Move card to top of list ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh top # Move card to bottom of list ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh bottom # Set specific position (number or 'top'/'bottom') ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh position 12345 ``` ### Comments ```bash # Add comment ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh comment "Comment text" # List comments ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh comments ``` ### Archive & Delete ```bash # Archive card ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh archive # Restore archived card ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh unarchive # Delete permanently ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh delete ``` ### Card Details ```bash # Show labels ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh labels # Show assigned members ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh members # Show checklists ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh checklist ``` ## Workflow: Smart Sorting (e.g., Shopping List by Category) When user wants to sort cards by category (like food items by store section): 1. Get all cards in the list as JSON: ```bash ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh list-json ``` 2. Analyze the card names and categorize them (e.g., Produce, Dairy, Meat, Bakery, Frozen, etc.) 3. Propose the new order to the user, grouped by category 4. After approval, update positions for each card: ```bash # First card gets position 1000 ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh position 1000 # Second card gets position 2000 ${CLAUDE_SKILL_DIR}/scripts/trello-cards.sh position 2000 # And so on... ``` This keeps the original list but reorders cards so same-category items are grouped together. ## Workflow: Adding Items Always confirm before creating: 1. Parse user's request for: list, card title, optional description 2. Find the appropriate board/list if not specified 3. Show proposed card details to user 4. Create card only after explicit approval ## Error Handling - **Invalid credentials**: Re-run setup - **Board/list not found**: Check ID or use find command - **Rate limited**: Wait a few seconds and retry (300 req/10s per key) ## Notes - Board/List/Card IDs can be found in Trello URLs or via list commands - The API key and token provide full access to your Trello account - keep them secret! - Rate limits: 300 requests per 10 seconds per API key; 100 requests per 10 seconds per token ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [dbhq-uk](https://github.com/dbhq-uk) - **Source:** [dbhq-uk/trello-skill](https://github.com/dbhq-uk/trello-skill) - **License:** MIT - **Homepage:** https://dbhq.uk Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-dbhq-uk-trello-skill-trello - Seller: https://agentstack.voostack.com/s/dbhq-uk - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.