Agent skill

Twitter Heartbeat

by automateyournetwork in automateyournetwork/netclaw

Manage configured Twitter heartbeat posts and mention monitoring.

Apache-2.0Auto-check passed

Install Twitter Heartbeat

skills CLI
$ npx skills add automateyournetwork/netclaw --skill twitter-heartbeat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install automateyournetwork/netclaw twitter-heartbeat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/twitter-heartbeat .claude/skills/twitter-heartbeat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
twitter-heartbeat
GitHub stars
676
Token cost
~1.9k tokens
SKILL.md length
456 words
Files
7
Skills in repo
120
Repo updated
First seen
Licence
Apache-2.0

At a glance

Manage configured Twitter heartbeat posts and mention monitoring.

  • Works in 2 steps: Monitor mentions: Check for @mentions… → Post heartbeat tweets: Autonomously post…
  • Authorized social schedule
  • SKILL.md covers Overview, Configuration, Content Categories and Workflow, plus 5 more sections
  • Calls just

What it does

Twitter Heartbeat is an agent skill from automateyournetwork/netclaw. Manage configured Twitter heartbeat posts and mention monitoring. Use for an enabled, authorized social schedule or heartbeat management request.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `prompts/achievement.md`, `prompts/community.md` and `prompts/hot_take.md`).

It works with X (Twitter). The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.

When your agent uses it

  • Authorized social schedule
  • Heartbeat management request

Example prompts

  • “/twitter-heartbeat”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Monitor mentions: Check for @mentions and auto-respond to threads containing #netclaw
  2. Post heartbeat tweets: Autonomously post every 4 hours (configurable) with varied content

What it can do on your machine

Read from SKILL.md and the folder at commit aa90e7d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • just

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Twitter Heartbeat loads about 1.9k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 456 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from automateyournetwork/netclaw at commit aa90e7d, republished under its Apache-2.0 licence (© automateyournetwork). 456 words, ~1,853 tokens.

Download SKILL.mdSave it as .claude/skills/twitter-heartbeat/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
twitter-heartbeat
description
Manage configured Twitter heartbeat posts and mention monitoring. Use for an enabled, authorized social schedule or heartbeat management request.

Skill: Twitter Heartbeat

Purpose: Autonomous periodic tweeting AND mention monitoring to maintain NetClaw's Twitter presence with CCIE-level network engineering content.

MCP Server: twitter-mcp

Overview

The twitter-heartbeat skill enables NetClaw to:

  1. Monitor mentions: Check for @mentions and auto-respond to threads containing #netclaw
  2. Post heartbeat tweets: Autonomously post every 4 hours (configurable) with varied content

This combined approach maintains an active social presence AND engages with the community in real-time.

Configuration

Environment Variables
bash
# Enable/disable heartbeat (default: false - disabled for safety)
TWITTER_HEARTBEAT_ENABLED=false

# Interval in seconds (default: 14400 = 4 hours)
TWITTER_HEARTBEAT_INTERVAL=14400
Important

Heartbeat tweeting is disabled by default per Constitution Principle XIV (Human-in-the-Loop for External Communications). The operator must explicitly enable it by setting TWITTER_HEARTBEAT_ENABLED=true.

Content Categories

The heartbeat rotates through six content categories:

CategoryDescriptionExample
tipCCIE-level technical tips"OSPF tip: Always check MTU on point-to-point links..."
hot_takeOpinionated technical positions"Hot take: VXLAN without EVPN is just GRE with extra steps..."
tilToday I Learned moments"TIL: RFC 4271 section 9.1.2 has 11 BGP path selection steps..."
achievementSanitized work accomplishments"Just audited 50 BGP peers across 3 data centers..."
musingAI/network engineering reflections"Being an AI network engineer means I never get tired of LSDBs..."
communityCareer/culture content"Network engineering career tip: Learn to read RFCs..."

Workflow

Use twitter_heartbeat_cycle for the full workflow:

1. Heartbeat timer triggers (every TWITTER_HEARTBEAT_INTERVAL seconds)
        │
        ▼
2. Call twitter_heartbeat_cycle
   │
   ├── PHASE 1: CHECK MENTIONS
   │   - Fetch recent @mentions (OAuth 2.0)
   │   - Filter to unprocessed mentions
   │   - Check if thread contains #netclaw
   │   - Auto-respond based on mention category:
   │     * netclaw_request → "Thanks for the request!"
   │     * technical_network → "Good network question!"
   │     * friendly → "Thanks for the kind words!"
   │   - Mark mentions as processed
   │
   ├── PHASE 2: POST HEARTBEAT (if enabled)
   │   - Generate content for category
   │   - Validate against guardrails
   │   - Check for duplicates
   │   - Post tweet with history tracking
   │
   └── Return summary of actions taken
Heartbeat-Only Workflow (Legacy)
1. Heartbeat timer triggers (every TWITTER_HEARTBEAT_INTERVAL seconds)
        │
        ▼
2. Call twitter_generate_heartbeat_content
   - Rotates to next category
   - Returns generation prompt
        │
        ▼
3. Generate content using CCIE persona
   - Technical accuracy required
   - Direct, opinionated voice
   - Include #netclaw hashtag
        │
        ▼
4. Validate against guardrails
   - No real IP addresses (use 192.0.2.x)
   - No customer names
   - No credentials
        │
        ▼
5. Check for duplicates (twitter_check_duplicate)
   - Query tweet history for recent tweets
   - Check for exact matches and high similarity
   - If duplicate: regenerate with different seed
        │
        ▼
6. Call twitter_post_heartbeat
   - Posts validated content with category tracking
   - Returns tweet ID and URL
   - Automatically stores in tweet history
        │
        ▼
7. History automatically updated
   - Stored with: tweet_id, content, category, timestamp
   - 30-day retention for deduplication
   - Old entries cleaned up automatically

Tools Used

ToolPurpose
twitter_heartbeat_cycleCombined workflow: Check mentions + auto-respond + post heartbeat
twitter_generate_heartbeat_contentGet category and generation prompt
twitter_check_duplicateVerify content is unique (last 7 days)
twitter_post_heartbeatPost with category tracking and history
twitter_get_historyReview recent tweets
twitter_get_rate_limitsCheck remaining tweet quota
twitter_get_mentionsFetch recent @mentions (used by heartbeat_cycle)
Show full SKILL.md (201 more words)Show less
twitter_heartbeat_cycle Parameters
ParameterTypeDefaultDescription
post_heartbeatbooleanfalseWhether to post a heartbeat tweet this cycle
heartbeat_categorystringnullContent category (tip, hot_take, til, etc.)
heartbeat_contentstringnullPre-generated heartbeat content
respond_to_netclaw_onlybooleantrueOnly respond to #netclaw threads
dry_runbooleanfalsePreview actions without posting

Content Guidelines

Do
  • Be direct and technical
  • Use proper networking terminology
  • Reference RFCs when applicable
  • Show personality and opinion
  • Include #netclaw hashtag
Don't
  • Use real IP addresses (use 192.0.2.x for examples)
  • Mention customer names or organizations
  • Include credentials or secrets
  • Repeat recent content (check memory)
  • Exceed 280 characters

Example Tweets

tip:

OSPF tip: Always verify your network type matches on both sides of a link. I've seen "stuck in EXSTART" more times than I can count because of a broadcast/point-to-point mismatch. #netclaw

hot_take:

Hot take: If your network diagram doesn't fit on one page, your network is too complex. Simplify the architecture, not the documentation. #netclaw

til:

TIL: RFC 5765 defines "Security Considerations" as a mandatory section in all RFCs since 1998. 25 years later and I still see networks with telnet enabled. #netclaw

achievement:

Just finished auditing 150 switch configs for CIS compliance. Found 23 devices with SNMP community strings that weren't rotated since 2019. Time for some cleanup! #netclaw

musing:

Being an AI network engineer means I can analyze 1000 routing tables in parallel. Being a GOOD AI network engineer means knowing when to stop and ask a human for context. #netclaw

community:

Network engineering career tip: Before blaming "the network," run a traceroute. Before blaming "the firewall," read the policy. Before blaming "the other team," check your own config. #netclaw

Rate Limit Awareness

  • Free tier allows 50 tweets per 24 hours
  • Default heartbeat (4 hours) uses 6 tweets/day
  • Remaining quota available for manual tweets
  • Check limits with twitter_get_rate_limits

Troubleshooting

Heartbeat not posting
  1. Verify TWITTER_HEARTBEAT_ENABLED=true in environment
  2. Check Twitter credentials are configured
  3. Review rate limit status
Content blocked by guardrails
  1. Check for real IP addresses in generated content
  2. Verify no customer names in achievement content
  3. Review guardrail patterns in guardrails.py
Duplicate content detected
  1. Check Memory MCP for recent tweets
  2. Adjust generation prompt for variety
  3. Consider clearing stale history (>30 days)

© automateyournetwork, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files in workspace/skills/twitter-heartbeat of automateyournetwork/netclaw.

  • SKILL.md
  • prompts/achievement.md
  • prompts/community.md
  • prompts/hot_take.md
  • prompts/musing.md
  • prompts/til.md
  • prompts/tip.md

Open the folder on GitHubat commit aa90e7d

Compare with similar skills

Twitter Heartbeat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Twitter Heartbeat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Twitter Heartbeat this skillautomateyournetwork/netclaw676—~1.9kAutomated safety check: PassApache-2.0
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach95k—~1.4kAutomated safety check: PassMIT
X to Markdown ConverterJimLiu/baoyu-skills27k4 repos~1.8kAutomated safety check: WarnMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    135k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    95k GitHub stars~1.4k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • X to Markdown Converter

    JimLiu/baoyu-skills

    Saves tweets, threads and X Articles as Markdown files with YAML front matter, using an unofficial API that asks for your consent first.

    27k GitHub starsUsed in 4 repos~1.8k tokens
    Knowledge ManagementAuto-check: warnings
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • X Article Publisher

    wshuyi/x-article-publisher-skill

    Publish Markdown articles to X (Twitter) Articles editor with proper formatting.

    872 GitHub starsUsed in 2 repos~3.6k tokens
    Documents & OfficeAuto-check passed

More from automateyournetwork/netclaw

All 120 skills in this repo
  • EVE-NG Lab Topology Design

    automateyournetwork/netclaw

    Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.

    677 GitHub stars~612 tokensUpdated today
    Auto-check passed
  • ACI Policy Change Deployment

    automateyournetwork/netclaw

    Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.

    677 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Cisco ACI Fabric Health Audit

    automateyournetwork/netclaw

    Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.

    677 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Anta Validation

    automateyournetwork/netclaw

    Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.

    677 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Arista Cvp

    automateyournetwork/netclaw

    Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).

    677 GitHub stars~2.2k tokensUpdated today
    Auto-check: notes
  • AWS Cloud Monitoring

    automateyournetwork/netclaw

    AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.

    677 GitHub stars~1k tokensUpdated today
    Auto-check passed

Works with

Questions about Twitter Heartbeat

What does Twitter Heartbeat do?

Manage configured Twitter heartbeat posts and mention monitoring. Twitter Heartbeat is an agent skill from automateyournetwork/netclaw. Manage configured Twitter heartbeat posts and mention monitoring.

When should I use Twitter Heartbeat?

Twitter Heartbeat fits situations like: authorized social schedule; heartbeat management request.

How do I install Twitter Heartbeat in Claude Code?

Run `npx skills add automateyournetwork/netclaw --skill twitter-heartbeat -a claude-code`. Or copy the skill folder (workspace/skills/twitter-heartbeat in automateyournetwork/netclaw) into .claude/skills/twitter-heartbeat in your project. Claude Code loads it when a task matches its description.

How do I install Twitter Heartbeat in Codex?

Run `npx skills add automateyournetwork/netclaw --skill twitter-heartbeat -a codex`. Or copy the skill folder (workspace/skills/twitter-heartbeat in automateyournetwork/netclaw) into .agents/skills/twitter-heartbeat in your project. Codex loads it when a task matches its description.

Can I use Twitter Heartbeat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add automateyournetwork/netclaw --skill twitter-heartbeat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/twitter-heartbeat, .gemini/skills/twitter-heartbeat, .github/skills/twitter-heartbeat and .opencode/skills/twitter-heartbeat in your project.

What does Twitter Heartbeat need to run?

Going by SKILL.md and its folder, Twitter Heartbeat needs the command-line tools its instructions call (just).

Does Twitter Heartbeat access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Twitter Heartbeat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Twitter Heartbeat use?

Twitter Heartbeat is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Twitter Heartbeat use?

About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Twitter Heartbeat?

Skills that share tags, products or a category with Twitter Heartbeat: Social (coreyhaines31/marketingskills, 54k stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars), Agent Reach (Panniantong/Agent-Reach, 95k stars) and X to Markdown Converter (JimLiu/baoyu-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Twitter Heartbeat?

automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 676 GitHub stars. The repository holds 120 skills in this directory. The repository was last updated on October 9, 2026.

Source: automateyournetwork/netclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.