How do I install the Trello Import skill?

Run npx skillmds@latest add tomevault-io/trello-import in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Trello Import safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Trello Import?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Trello Import free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Trello Import?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Trello Import by tomevault-io — Agent Skill

Name: Trello Import
Author: tomevault-io

Trello Import

This skill should be used when the user asks to "import Trello boards", "convert Trello JSON to Markdown", "generate Obsidian notes from Trello", or has placed Trello JSON exports at the repository root. Converts Trello board JSON exports into browsable Obsidian Markdown notes organized by board, list, and card. Use when this capability is needed.

tomevault-io 8accf02 2 files · 3.1 KB Updated Sep 17, 2026

File contents

Trello Import Skill

Convert Trello board JSON exports into Markdown notes for Obsidian.

When to Use

User has placed one or more *.json Trello board exports at the repository root
User wants to (re-)generate the TRELLO_IMPORT/ folder structure

Bundled Script

The converter script is bundled at scripts/import_from_trello.py. Run it from the repository root:

# Import one board only (recommended)
python3 .claude/skills/trello-import/scripts/import_from_trello.py 20260214_pok-pok-noodles.json

# Import multiple explicit boards
python3 .claude/skills/trello-import/scripts/import_from_trello.py 20260214_foodie-rezepte.json 20260214_hot-thai-kitchen.json

Do not run the script without explicit JSON file arguments.

Behavior

Read only the explicitly provided *.json files
If a target board directory already exists, prompt for explicit approval before deleting/recreating it
In non-interactive mode, always refuse overwrite of existing board directories
Write to TRELLO_IMPORT/<Board>/<List>/<Card>/index.md
Lists are sorted by Trello position and prefixed: 001 ListName/, 002 ListName/
Each card gets YAML frontmatter (title, board, list, trello_url) plus sections for description and attachments
Duplicate card names within a list get [<card-id>] appended for collision safety
Filenames are sanitized (max 120 chars, safe unicode)

Warning

Destructive per imported board: for each selected JSON file, the script deletes and recreates that board directory (shutil.rmtree). Never hand-edit files inside TRELLO_IMPORT/. Overwrite is interactive-only: existing board folders are never replaced in non-interactive runs.

Verify

find TRELLO_IMPORT -name index.md | head -20

Recommended Follow-Up

After importing, run the trello-media-download skill to download Trello-hosted images locally.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: trello-importdescription: This skill should be used when the user asks to "import Trello boards", "convert Trello JSON to Markdown", "generate Obsidian notes from Trello", or has placed Trello JSON exports at the repository root. Converts Trello board JSON exports into browsable Obsidian Markdown notes organized by board, list, and card. Use when this capability is needed.---# Trello Import SkillConvert Trello board JSON exports into Markdown notes for Obsidian.## When to Use- User has placed one or more `*.json` Trello board exports at the repository root- User wants to (re-)generate the `TRELLO_IMPORT/` folder structure## Bundled ScriptThe converter script is bundled at `scripts/import_from_trello.py`. Run it from the repository root:```bash# Import one board only (recommended)python3 .claude/skills/trello-import/scripts/import_from_trello.py 20260214_pok-pok-noodles.json# Import multiple explicit boardspython3 .claude/skills/trello-import/scripts/import_from_trello.py 20260214_foodie-rezepte.json 20260214_hot-thai-kitchen.json```Do not run the script without explicit JSON file arguments.## Behavior- Read only the explicitly provided `*.json` files- If a target board directory already exists, prompt for explicit approval before deleting/recreating it- In non-interactive mode, always refuse overwrite of existing board directories- Write to `TRELLO_IMPORT/<Board>/<List>/<Card>/index.md`- Lists are sorted by Trello position and prefixed: `001 ListName/`, `002 ListName/`- Each card gets YAML frontmatter (`title`, `board`, `list`, `trello_url`) plus sections for description and attachments- Duplicate card names within a list get `[<card-id>]` appended for collision safety- Filenames are sanitized (max 120 chars, safe unicode)## Warning**Destructive per imported board**: for each selected JSON file, the script deletes and recreates that board directory (`shutil.rmtree`). Never hand-edit files inside `TRELLO_IMPORT/`.Overwrite is interactive-only: existing board folders are never replaced in non-interactive runs.## Verify```bashfind TRELLO_IMPORT -name index.md | head -20```## Recommended Follow-UpAfter importing, run the `trello-media-download` skill to download Trello-hosted images locally.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/erich3000) — claim your Tome and manage your conversions.

Frequently asked questions