playbook/antigravity-awesome-skills/skills/github-presence/README.md

github-presence

Platform optimization skill — Optimize GitHub for discoverability and conversions.

What It Does

Guides you through GitHub optimization: README structure, badges, profile README, topics, awesome lists, GitHub Actions for marketing, and Sponsors setup.

When to Use

• Improving a project README
• Setting up a profile README
• Increasing GitHub discoverability
• When you say "GitHub README," "GitHub profile," "awesome lists," or "GitHub marketing"

Quick Start

/github-presence

Audit our GitHub README and suggest improvements.
We're an open source database tool trying to get
more stars and contributors.

Key Sections

1. README Structure — Anatomy of a great README
2. Badges — Which ones matter and how to add them
3. Profile README — Personal branding on GitHub
4. Discoverability — Topics, search, awesome lists
5. GitHub Actions — Automation for marketing
6. GitHub Sponsors — Monetization setup

README Must-Haves

Section	Purpose
Logo/Banner	Visual identity
Badges	Trust signals
One-liner	What it does
Quick Start	< 2 min to running
Features	Why use this
Installation	All methods
Documentation	Link to full docs
License	Legal clarity

Discoverability Tactics

Tactic	How
Topics	Add up to 20 relevant topics
Description	350 chars, keyword-rich
Awesome lists	Submit PRs to curated lists
Social preview	Upload custom image

Tools

• Octolens — Monitor GitHub mentions and discussions
• Shields.io — Generate badges
• readme.so — README generator

Related Skills

• developer-audience-context — Know who evaluates your repo
• hacker-news-strategy — HN users check GitHub first
• reddit-engagement — Redditors evaluate via GitHub