github-presence

name	github-presence
description	Improves GitHub discoverability: README anatomy and badges, username profile README, topics, awesome-list submissions, FUNDING.yml, and traffic/star signals. Use for making a repo findable via README, topics, profile page, or awesome-list PRs. Not for Actions log debugging, PR merge mechanics, or application feature work.
version	1.0.1
risk	unknown
source	https://github.com/jonathimer/devmarketing-skills/tree/main/skills/github-presence
source_repo	jonathimer/devmarketing-skills
source_type	community
date_added	2026-07-01T00:00:00.000Z
license	MIT
license_source	https://github.com/jonathimer/devmarketing-skills/blob/main/LICENSE

GitHub Presence

Overview

GitHub is where developers evaluate your project before trying it. This skill covers README optimization, profile READMEs, discoverability through topics and awesome lists, and using GitHub features for marketing. Treat your GitHub presence as the first technical evaluation a developer performs — optimize accordingly.

When to Use

Use this skill when the user wants to optimize their GitHub profile, README, or project discoverability. Trigger phrases include:

• "GitHub README"
• "README optimization"
• "GitHub profile"
• "GitHub stars"
• "GitHub discoverability"
• "awesome lists"
• "GitHub marketing"

Prerequisites

1. Read .agents/developer-audience-context.md if it exists — this file provides context about who evaluates the repository.
2. Audit your current GitHub presence (profile, pinned repos, READMEs) before making changes.
3. Confirm you have push access to the target repository or profile README repo.

Procedure

1. Audit Current Presence

1. Open the target repository on GitHub.
2. Review the existing README for structure, badges, quick start, and license.
3. Check repository settings for topics (up to 20 allowed).
4. Review the profile README if one exists (repo named exactly after the username).
5. Check Insights → Traffic for current views, clones, and referrers.

2. README Structure

A great README follows this anatomy:

Section	Purpose	Required?
Logo/Banner	Brand recognition, visual appeal	Recommended
Badges	Quick trust signals, status	Recommended
One-liner	What it does in one sentence	Required
Hero example	Immediate "what does it look like?"	Highly recommended
Features	Why use this over alternatives	Required
Quick start	Get running in < 2 minutes	Required
Installation