Letterboxd Skill

This skill allows the agent to retrieve information about movies or user activity from Letterboxd.

Setup

pip install letterboxdpy

Usage

Use this when the user asks about:

• Their Letterboxd profile stats
• Movies they've watched recently
• Their watchlist
• Specific movie details

Commands

lb_user

• command: python lb_tool.py user "{{username}}"
• description: Gets user profile stats (watched count, reviews, lists, favorites)
• parameters:
• username: The Letterboxd username

lb_diary

• command: python lb_tool.py diary "{{username}}" [limit]
• description: Gets recently watched movies from user's diary
• parameters:
• username: The Letterboxd username
• limit: Optional, default 10

lb_watchlist

• command: python lb_tool.py watchlist "{{username}}" [limit]
• description: Gets movies in user's watchlist
• parameters:
• username: The Letterboxd username
• limit: Optional, default 10

lb_movie

• command: python lb_tool.py movie "{{slug}}"
• description: Gets movie details (title, year, rating, directors, description)
• parameters:
• slug: Movie URL slug (e.g., vikram-2022, the-batman)

Examples

User: "How many movies have I watched on Letterboxd?"

Agent: (Calls lb_user with username="tamilventhan")

User: "What movies did I watch recently?"

Agent: (Calls lb_diary with username="tamilventhan")

User: "Show my watchlist"

Agent: (Calls lb_watchlist with username="tamilventhan")

User: "Tell me about the movie Vikram"

Agent: (Calls lb_movie with slug="vikram-2022")