One-click install
npx skills add https://github.com/ma08/botfiles --skill birdclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: birdclaw
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/birdclaw
Command: npx skills add https://github.com/ma08/botfiles --skill birdclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the inefficiency and cost of unnecessary live X/Twitter API calls by prioritizing local SQLite cache reads for follow graph and related data analysis, avoiding rate limits and stale data from repeated live requests.

Core Features & Use Cases

  • Cache-First Follow Graph Analysis: Query cached data for followers, following, mutuals, non-mutual connections, unfollowers, and top followers without hitting live X APIs.
  • Controlled Live Sync Workflows: Run intentional, dry-run supported live syncs with partial snapshot options to retrieve fresh data only when the local cache is stale or missing.
  • Use Case: For example, track which accounts unfollowed you over the past month, identify your top 100 followers by their follower count, or export a portable backup of your entire follow graph for safekeeping.

Quick Start

Use the birdclaw skill to analyze my cached X follower data and list the 20 accounts I follow that do not follow me back, sorted by their follower count.

Frequently Asked Questions about birdclaw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze my X/Twitter follow graph without hitting API rate limits?

Tracking X/Twitter unfollowers using cached SQLite data lets you compare historical follower snapshots without live API calls. You can identify accounts that unfollowed you over a specific period by querying the local cache, avoiding rate limits from repeated live requests.

How do I track X/Twitter unfollowers using cached data?

Tracking X/Twitter unfollowers using cached SQLite data lets you compare historical follower snapshots without live API calls. You can identify accounts that unfollowed you over a specific period by querying the local cache, avoiding rate limits from repeated live requests.

Do I need the Birdclaw CLI tool to export my Twitter follower graph backup?

Yes, you need the Birdclaw CLI tool configured with a local SQLite cache to export your Twitter follower graph backup. The CLI manages the cache database and handles optional live syncs to retrieve fresh data when your cached information is stale.

Can I sync fresh Twitter data when my local cache is stale?

You can sync fresh Twitter data when your local cache is stale by running controlled live sync workflows. These intentional syncs support dry-runs and partial snapshots, ensuring you only hit the live X API when cached data is missing or outdated.

What's the best way to rank my top 100 Twitter followers by follower count?

The best way to rank your top 100 Twitter followers by follower count is by querying your local SQLite cache. This approach processes your follow graph instantly offline, avoiding the rate limits and latency associated with live social analytics API requests.

When should I avoid using a cache-first approach for social analytics?

You should avoid a cache-first approach for social analytics when you require real-time data accuracy, such as monitoring live trending topics. The cache-first method prioritizes API optimization and historical analysis, meaning freshly updated timeline or DM data requires a manual live sync.