sync-trello

Syncs Goals, Micro-Goals, and Tasks from .work/PLAN.md to Trello cards and checklists.

3|Updated Oct 28, 2020
One-click install
npx skills add https://github.com/k0d3x8its/dotfiles --skill sync-trello-k0d3x8its
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-trello
Source: https://github.com/k0d3x8its/dotfiles/tree/main/claude/.claude/skills/sync-trello
Command: npx skills add https://github.com/k0d3x8its/dotfiles --skill sync-trello-k0d3x8its

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a local project plan in sync with a Trello board requires manually recreating every Goal as a card and every task as a checklist item, which is repetitive and error-prone. This Skill automates that push from .work/PLAN.md to Trello while avoiding duplicate cards on repeat runs. ## Core Features & Use Cases - Hierarchical Sync: Maps Goals to Trello cards, Micro-Goals to checklists, and Tasks to checklist items in the board's Back Log list. - Idempotent Operation: Skips Goals already tagged with [trello:CARD_ID] and annotates the plan file immediately after each card is created, so partial failures never cause duplicates. - Per-Project Board Resolution: Reads the target board from a .claude/trello-board file, a command argument, or an interactive prompt that can save the choice. - Use Case: After drafting a sprint plan in .work/PLAN.md with three Goals and their tasks, run the sync once to create all cards and checklists on your project board, then re-run it later to push only newly added Goals. ## Quick Start Ask the AI to run /sync-trello to push the Goals from .work/PLAN.md to your Trello board as cards with checklists.

Frequently Asked Questions about sync-trello

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a Markdown project plan to Trello?▼

Run /sync-trello with a .work/PLAN.md file containing Goals, Micro-Goals, and checkbox Tasks. Each Goal becomes a Trello card, each Micro-Goal a checklist, and each Task a checklist item in the Back Log list.

How do I avoid creating duplicate Trello cards when re-running a sync?▼

The sync is idempotent: after a card is created, the Goal line is annotated with a [trello:CARD_ID] tag. On subsequent runs, any Goal carrying that tag is skipped entirely, so only new Goals are synced.

Can I use a different Trello board for each project?▼

Yes. Board resolution is per-project: pass a board name as an argument, or store it in a .claude/trello-board file in the project root. If neither exists, you are prompted to pick a board and can save the choice.

What happens if creating a Trello card or checklist fails?▼

Failures are isolated: a failed card skips its checklists, a failed checklist skips its items, and the sync continues with the next item. The plan file is only annotated after a card is successfully created, and failed commands are never retried.

Does the sync handle completed tasks in the plan file?▼

Yes. Both unchecked (- [ ]) and checked (- [x]) task lines are synced as Trello checklist items, with the checkbox prefix stripped. Tasks not nested under a Micro-Goal are ignored since they have no checklist.