Github Monitor

GitHub Monitor Skill

Monitor your public GitHub repos. When new repos appear or significant updates happen, generate social media drafts and send for approval.

Configuration

Set your GitHub username at the top of your state file or as an env var:

export GITHUB_USERNAME="yourusername"

Core Principle

Product is content. Don't fabricate stories. Translate "what I built" into social posts.

Detection Logic

1. Fetch Current Repos

# New repos (sorted by creation date)
gh api /users/$GITHUB_USERNAME/repos?sort=created&per_page=10

# Recently updated repos (sorted by push date)
gh api /users/$GITHUB_USERNAME/repos?sort=pushed&per_page=10

2. Compare Against State

Read memory/github-monitor-state.json and compare.

3. Trigger Conditions (any one triggers a draft)

4. Gather Content for Draft

# Read README
gh api /repos/$GITHUB_USERNAME/{repo}/readme --jq .content | base64 -d

# Recent commits
gh api /repos/$GITHUB_USERNAME/{repo}/commits?per_page=5

# Repo metadata (description, language, stars, forks)
gh api /repos/$GITHUB_USERNAME/{repo}

Draft Generation Rules

Voice & Tone

• First-person perspective
• Authentic, technical, no hype
• Show the work, not the dream

Banned Words

NEVER use: Revolutionize, Supercharge, Game-changer, 10x, Viral, Hacks, Disrupt, Groundbreaking, Revolutionary, Mind-blowing

Reddit Draft

Target subreddits: r/SideProject, r/coolgithubprojects (pick based on repo type)

Format:

Title: [Concise, descriptive — what it does]

Body:
## The Problem
[1-2 sentences: what pain point this solves]

## What I Built
[2-3 sentences: what the repo does, key features]

## How It Works
[Brief technical overview, stack/approach]

## What I Learned
[1-2 genuine takeaways from building this]

GitHub: https://github.com/{username}/{repo}

Happy to answer questions!

Twitter Draft

Format: 1-3 tweets, concise and punchy.

Tweet 1: [Hook — what problem + what I built]
Tweet 2: [Key technical detail or interesting finding]
Tweet 3: [Link + invitation to check it out]

GitHub: https://github.com/{username}/{repo}

Keep each tweet under 280 chars. Natural flow.

Approval Flow

Send Draft to User

New project detected!

{repo_name}
{description}

--- Reddit Draft (r/{subreddit}) ---
{reddit_draft}

--- Twitter Draft ---
{twitter_draft}

Reply "post" to publish both, or tell me what to change.

User Responses

Publishing

Reddit

Use AppleScript Chrome automation (see reddit-cultivate skill):

1. Get modhash from /api/me.json
2. POST to /api/submit with:
   • sr: subreddit name
   • kind: "self"
   • title: post title
   • text: post body (markdown)
   • uh: modhash

Twitter

Use Twikit:

cd ~/crawlee-social-scraper  # or wherever your Twikit setup lives
source venv/bin/activate
python3 -c "
import asyncio
from twikit import Client

async def post():
    client = Client('en-US')
    client.load_cookies('twitter_cookies.json')
    await client.create_tweet(text='''TWEET_TEXT_HERE''')

asyncio.run(post())
"

After Publishing

1. Record published URLs in memory/github-monitor-state.json under posted_repos
2. Log to daily memory file memory/YYYY-MM-DD.md
3. Report back: "Published! Reddit: [url] | Twitter: [url]"

State File

Location: memory/github-monitor-state.json

{
  "github_username": "yourusername",
  "last_checked": "2026-01-01T09:00:00Z",
  "known_repos": {
    "repo_name": {
      "created_at": "2026-01-01T16:37:12Z",
      "last_pushed_at": "2026-01-01T17:58:31Z",
      "last_known_commits": 5,
      "stars": 1
    }
  },
  "posted_repos": ["repo_name"],
  "star_milestones_notified": {
    "repo_name": [10]
  }
}

First Run Behavior

On the very first run (when last_checked is null):

1. Fetch all public repos
2. Record them ALL in known_repos (baseline snapshot)
3. Do NOT trigger any notifications
4. Reply: "First sync complete. Recorded {N} public repos. Will notify you of new repos and significant updates going forward."

Cron Schedule

Runs 3x daily: 09:00, 15:00, 21:00 (your local time)

If nothing new: reply HEARTBEAT_OK (no notification).

Star Milestones

When a repo crosses a milestone, send a celebratory notification:

Your repo {repo_name} just hit {milestone} stars!

Current: {stars} stars | {forks} forks

Want me to draft a "milestone update" post?

Milestones: 10, 50, 100, 500, 1000, 5000, 10000