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)

Condition	How to Detect
New public repo	`created_at` newer than any known repo
Significant update	`pushed_at` changed AND >= 3 new commits since last check
Star milestone	Stars crossed 10, 50, 100, 500, 1000

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

User says	Action
"post" / "send" / "go"	Publish to Reddit + Twitter
"reddit only"	Publish Reddit only
"twitter only"	Publish Twitter only
"change X to Y"	Revise draft and re-send
No reply	Do nothing. NEVER auto-post.

Publishing

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

Get modhash from /api/me.json
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

Record published URLs in memory/github-monitor-state.json under posted_repos
Log to daily memory file memory/YYYY-MM-DD.md
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):

Fetch all public repos
Record them ALL in known_repos (baseline snapshot)
Do NOT trigger any notifications
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