About cleanup-deleted
A skill for removing deleted or banned accounts from Telegram dialogs and contacts. It scans regular and archived dialogs, retries stubborn entries with progressively stronger deletion methods, and supports scanning without making changes.
Key features
- 01Scan regular and archived dialogs
- 02Remove deleted accounts and contacts
- 03Retry stubborn entries with three deletion methods
- 04Scan without deleting using dry-run
- 05Choose profiles to clean
Use cases
- 01Remove Deleted Account entries from chat lists
- 02Clear contacts left by deleted accounts
- 03Review matching entries before cleanup
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/cleanup-deletedin Claude Code to confirm it loaded.
Details
From the project READMECleanup Deleted Telegram Accounts
Scan and purge deleted/ghost accounts from your Telegram dialog list and contacts. These are accounts that were deleted by their owners or banned by Telegram but still appear as "Deleted Account" in your chat list.
The script uses 3 progressively aggressive deletion methods because Telegram's dialog cache can be stubborn:
- delete_dialog — standard removal
- DeleteHistoryRequest — force-clear the conversation history
- Block + Unblock + delete — resets Telegram's peer state cache, then deletes
After the first pass, it re-scans for survivors and retries with method 3.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Preflight
- Session must exist:
~/.local/share/gramjs/<profile>.session- If missing, run
/tlg:setupfirst
- If missing, run
Usage
/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/cleanup_deleted.ts"
# Scan only (no deletions)
bun "$SCRIPT" --dry-run
# Clean all profiles
bun "$SCRIPT"
# Clean specific profile
bun "$SCRIPT" -p work
# Clean multiple specific profiles
bun "$SCRIPT" -p work personal
EOF
Parameters
| Parameter | Type | Description |
|---|---|---|
-p/--profile | list | Profiles to clean (default: all) |
--dry-run | flag | Scan and report without deleting |
What Gets Cleaned
| Source | Action |
|---|---|
| Regular dialogs | Deleted user chats removed |
| Archived dialogs (folder=1) | Deleted user chats removed |
| Contact list | Deleted contacts removed |
| Stubborn ghosts | Block+unblock forces cache reset, then delete |
Recommended Cadence
Run monthly or whenever you notice "Deleted Account" entries appearing in your chat list. Spam accounts that message you and later get banned by Telegram are the primary source.
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If tg-cli.ts's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.