# Letterboxd Tracker

> Your personal movie assistant. Track what you watch, check your lists, and get movie info from Letterboxd instantly.

- Skill: `johnalbertini14-glitch/letterboxd-tracker` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/letterboxd-tracker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/letterboxd-tracker/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/letterboxd-tracker

---


# Letterboxd Skill

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

## Setup

```bash
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")