unfollow-management
Skill648 starsChanged 9 months agoApache-2.0View on GitHub
Mass unfollow on X/Twitter via browser console scripts. Unfollows everyone, only non-followers, non-followers with username logging, smart time-based unfollow with whitelists, and follow/following ratio management. Use when cleaning up a following list, removing non-followers, bulk unfollowing accounts, or optimizing your follow ratio.
In this repository60 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- python/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- python/CLAUDE.mdCLAUDE.md
- xspace-agents/CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- llms-full.txtllms.txt
- llms.txtllms.txt
- python/llms-full.txtllms.txt
- python/llms.txtllms.txt
- a2a-multi-agentSkill
- account-backupSkill
- account-toolsSkill
- algorithm-cultivationSkill
- analytics-insightsSkill
- articles-longformSkill
- billing-managementSkill
- blocking-muting-managementSkill
- bookmarks-managementSkill
- business-adsSkill
- community-health-monitoringSkill
- community-managementSkill
- community-notesSkill
- competitor-intelligenceSkill
- content-cleanupSkill
- content-postingSkill
- content-repurposingSkill
- creator-monetizationSkill
- crm-managementSkill
- delegate-accessSkill
- direct-messagesSkill
- discovery-exploreSkill
- engagement-interactionSkill
- follower-monitoringSkill
- graph-analysisSkill
- grok-aiSkill
- growth-automationSkill
- lead-generationSkill
- lists-managementSkill
- media-studioSkill
- notifications-managementSkill
- post-editingSkill
- premium-subscriptionsSkill
- profile-managementSkill
- reputation-auditSkill
- saved-searchesSkill
- settings-privacySkill
- spaces-liveSkill
- teams-managementSkill
- timeline-viewingSkill
- topic-managementSkill
- twitter-scrapingSkill
- video-downloadingSkill
- viral-thread-generationSkill
- webhooksSkill
- x402-paymentsSkill
- xactions-cliSkill
- xactions-mcp-serverSkill
- x-pro-managementSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 2 are distinctive, and 9 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
9
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 35
Backoff: If rate limited, scripts wait 30–60 seconds before retrying
- Distinctive: line 37
Recovery: If action-restricted, wait 12–24 hours
- Very specific: line 43
Run src/followRatioManager.js on your profile to assess current ratio
- Very specific: line 44
Use XActions.plan() to see how many unfollows are needed
- Very specific: line 45
Run src/unfollowback.js to remove non-followers first (safest)
- Very specific: line 46
If more cleanup needed, use src/unfollowEveryone.js with abort when satisfied
- Very specific: line 52
Use src/followRatioManager.js weekly to monitor trends
- Very specific: line 53
Run src/unfollowback.js monthly to remove non-reciprocal follows
- Very specific: line 54
Keep a whitelist in smartUnfollow.js for accounts you always want to follow
- Very specific: line 59
Run src/unfollowWDFBLog.js (saves log of who was unfollowed)
- Very specific: line 61
Use src/followRatioManager.js to verify improvements
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Unfollow Management
Browser console scripts for managing who you follow on X/Twitter. All scripts run in DevTools console.
Script Selection
| Goal | File | Navigate to |
| Unfollow ALL accounts | src/unfollowEveryone.js | x.com/USERNAME/following |
| Unfollow only non-followers | src/unfollowback.js | x.com/USERNAME/following |
| Unfollow non-followers + download log | src/unfollowWDFBLog.js | x.com/USERNAME/following |
| Time-based smart unfollow with whitelist | src/automation/smartUnfollow.js | x.com/USERNAME/following |
| Detect who unfollowed you | src/detectUnfollowers.js | x.com/USERNAME/followers |
| Monitor follow/following ratio + plan | src/followRatioManager.js | x.com/USERNAME |
| Remove specific followers from YOUR list | src/removeFollowers.js | x.com/USERNAME/followers |
Script Details
For detailed algorithms, controls, configurations, and DOM selectors for each script, see references/script-details.md.
Rate Limiting & Safety
- Default delay: 1–2 seconds between unfollows (gaussian randomized)
- Batch delay: 2–3 seconds between scroll batches
- Rate limit detection: Scripts check for
[data-testid="toast"]warning banners - Backoff: If rate limited, scripts wait 30–60 seconds before retrying
- Daily limit guidance: X may restrict after ~400 unfollows/day; spread over multiple sessions
- Recovery: If action-restricted, wait 12–24 hours
Strategy Guide
Cleaning a bloated following list
- Run
src/followRatioManager.json your profile to assess current ratio - Use
XActions.plan()to see how many unfollows are needed - Run
src/unfollowback.jsto remove non-followers first (safest) - If more cleanup needed, use
src/unfollowEveryone.jswith abort when satisfied - Re-check ratio with
XActions.track()
Maintaining a healthy ratio over time
- Set up periodic runs of
src/detectUnfollowers.jsto track losses - Use
src/followRatioManager.jsweekly to monitor trends - Run
src/unfollowback.jsmonthly to remove non-reciprocal follows - Keep a whitelist in
smartUnfollow.jsfor accounts you always want to follow
Before a big unfollow session
- Export your following list first:
scripts/scrapeFollowing.js - Run
src/unfollowWDFBLog.js(saves log of who was unfollowed) - Review the downloaded log for any mistakes
- Use
src/followRatioManager.jsto verify improvements
Troubleshooting
| Problem | Solution |
| "No unfollow buttons found" | Make sure you're on the Following page, not Followers |
| Script stops after ~20 unfollows | X rate limit triggered — wait 1 hour and re-run |
| Confirmation dialog doesn't appear | DOM may have changed — check confirmationSheetConfirm selector |
| Script unfollows mutuals | Use unfollowback.js instead of unfollowEveryone.js |
| "Action restricted" warning | Account is temporarily limited — wait 12-24 hours |
| Script misses accounts | Re-run the script — some load below the scroll area |
Related Skills
- follower-monitoring — Track follower growth and detect unfollowers
- blocking-muting-management — Block/unblock for removing followers
- growth-automation — Grow followers to improve ratio organically
- analytics-insights — Understand engagement before unfollowing
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.