github-presence

Name: github-presence
Author: jonathimer

77installs6forks

How to install github-presence?

jonathimer/devmarketing-skills/github-presence

$npx -y skills add jonathimer/devmarketing-skills --skill github-presence

Installs into the current project.

Summary

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," or "GitHub marketing.

Files · 1

View on GitHub

SKILL.md

1	# GitHub Presence
2
3	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.
4
5	---
6
7	## Before You Start
8
9	1. Read `.agents/developer-audience-context.md` if it exists
10	2. Audit your current GitHub presence (profile, pinned repos, READMEs)
11	3. Understand: GitHub is often the first technical evaluation — optimize accordingly
12
13	---
14
15	## README Structure
16
17	### The Anatomy of a Great README
18
19	\| Section \| Purpose \| Required? \|
20	\|---------\|---------\|-----------\|
21	\| Logo/Banner \| Brand recognition, visual appeal \| Recommended \|
22	\| Badges \| Quick trust signals, status \| Recommended \|
23	\| One-liner \| What it does in one sentence \| Required \|
24	\| Hero example \| Immediate "what does it look like?" \| Highly recommended \|
25	\| Features \| Why use this over alternatives \| Required \|
26	\| Quick start \| Get running in < 2 minutes \| Required \|
27	\| Installation \| All installation methods \| Required \|
28	\| Usage \| Core usage examples \| Required \|
29	\| Documentation \| Link to full docs \| Required \|
30	\| Contributing \| How to contribute \| Recommended \|
31	\| License \| Legal clarity \| Required \|
32
33	### README Template
34
35	```markdown
36	<div align="center">
37	<img src="logo.svg" alt="Project Name" width="200">
38	<h1>Project Name</h1>
39	<p><strong>One compelling sentence explaining what this does.</strong></p>
40
41	<!-- Badges -->
42	<a href="https://github.com/org/repo/actions"><img src="https://github.com/org/repo/workflows/CI/badge.svg" alt="CI"></a>
43	<a href="https://www.npmjs.com/package/name"><img src="https://img.shields.io/npm/v/name.svg" alt="npm version"></a>
44	<a href="https://github.com/org/repo/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
45	<a href="https://discord.gg/invite"><img src="https://img.shields.io/discord/123456789" alt="Discord"></a>
46
47	<br>
48	<br>
49
50	<a href="https://docs.example.com">Documentation</a> •
51	<a href="https://example.com">Website</a> •
52	<a href="https://discord.gg/invite">Discord</a>
53	</div>
54
55	---
56
57	## Why Project Name?
58
59	- Feature 1 — Brief explanation
60	- Feature 2 — Brief explanation
61	- Feature 3 — Brief explanation
62
63	## Quick Start
64
65	```bash
66	npm install project-name
67	```
68
69	```javascript
70	import { thing } from 'project-name';
71
72	const result = thing.doSomething();
73	console.log(result);
74	```
75
76	## Installation
77
78	### npm
79	```bash
80	npm install project-name
81	```
82
83	### yarn
84	```bash
85	yarn add project-name
86	```
87
88	### pnpm
89	```bash
90	pnpm add project-name
91	```
92
93	## Usage
94
95	### Basic Example
96
97	```javascript
98	// Code example with comments
99	```
100
101	### Advanced Example
102
103	```javascript
104	// More complex example
105	```
106
107	## Documentation
108
109	Full documentation available at [docs.example.com](https://docs.example.com)
110
111	- [Getting Started](https://docs.example.com/getting-started)
112	- [API Reference](https://docs.example.com/api)
113	- [Examples](https://docs.example.com/examples)
114
115	## Contributing
116
117	We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
118
119	## License
120
121	MIT © [Your Name](https://yoursite.com)
122	```
123
124	---
125
126	## Badges That Matter
127
128	### Trust Signal Badges
129
130	\| Badge \| What it shows \| When to use \|
131	\|-------\|--------------\|-------------\|
132	\| CI/Build status \| Code quality \| Always \|
133	\| Version \| Latest release \| Always for packages \|
134	\| License \| Legal clarity \| Always \|
135	\| Downloads/installs \| Adoption \| When impressive \|
136	\| Coverage \| Test quality \| If > 70% \|
137	\| Security \| Audit status \| If you have it \|
138
139	### Community Badges
140
141	\| Badge \| Source \| Purpose \|
142	\|-------\|--------\|---------\|
143	\| Discord members \| shields.io \| Show active community \|
144	\| GitHub stars \| shields.io \| Social proof \|
145	\| Contributors \| shields.io \| Open source health \|
146	\| Last commit \| shields.io \| Project activity \|
147
148	### Badge Services
149
150	\| Service \| URL \| Best for \|
151	\|---------\|-----\|----------\|
152	\| Shields.io \| shields.io \| Most badges \|
153	\| Badgen \| badgen.net \| Fast, minimal \|
154	\| GitHub badges \| Native \| Actions, issues \|
155
156	### Badge Examples
157
158	```markdown
159	<!-- Build status -->
160	![CI](https://github.com/org/repo/workflows/CI/badge.svg)
161
162	<!-- npm version -->
163	[![npm](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)
164
165	<!-- Downloads -->
166	[![Downloads](https://img.shields.io/npm/dm/package-name.svg)](https://www.npmjs.com/package/package-name)
167
168	<!-- License -->
169	[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
170
171	<!-- Discord -->
172	[![Discord](https://img.shields.io/discord/SERVER_ID?color=7289da&logo=discord&logoColor=white)](https://discord.gg/invite)
173
174	<!-- Stars -->
175	[![GitHub sta

People who liked this also viewed

6 picks

Type

github-presence

77installs6forks

View on GitHub

How to install github-presence?

jonathimer/devmarketing-skills/github-presence

$npx -y skills add jonathimer/devmarketing-skills --skill github-presence

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# GitHub Presence
2
3	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.
4
5	---
6
7	## Before You Start
8
9	1. Read `.agents/developer-audience-context.md` if it exists
10	2. Audit your current GitHub presence (profile, pinned repos, READMEs)
11	3. Understand: GitHub is often the first technical evaluation — optimize accordingly
12
13	---
14
15	## README Structure
16
17	### The Anatomy of a Great README
18
19	\| Section \| Purpose \| Required? \|
20	\|---------\|---------\|-----------\|
21	\| Logo/Banner \| Brand recognition, visual appeal \| Recommended \|
22	\| Badges \| Quick trust signals, status \| Recommended \|
23	\| One-liner \| What it does in one sentence \| Required \|
24	\| Hero example \| Immediate "what does it look like?" \| Highly recommended \|
25	\| Features \| Why use this over alternatives \| Required \|
26	\| Quick start \| Get running in < 2 minutes \| Required \|
27	\| Installation \| All installation methods \| Required \|
28	\| Usage \| Core usage examples \| Required \|
29	\| Documentation \| Link to full docs \| Required \|
30	\| Contributing \| How to contribute \| Recommended \|
31	\| License \| Legal clarity \| Required \|
32
33	### README Template
34
35	```markdown
36	<div align="center">
37	<img src="logo.svg" alt="Project Name" width="200">
38	<h1>Project Name</h1>
39	<p><strong>One compelling sentence explaining what this does.</strong></p>
40
41	<!-- Badges -->
42	<a href="https://github.com/org/repo/actions"><img src="https://github.com/org/repo/workflows/CI/badge.svg" alt="CI"></a>
43	<a href="https://www.npmjs.com/package/name"><img src="https://img.shields.io/npm/v/name.svg" alt="npm version"></a>
44	<a href="https://github.com/org/repo/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
45	<a href="https://discord.gg/invite"><img src="https://img.shields.io/discord/123456789" alt="Discord"></a>
46
47	<br>
48	<br>
49
50	<a href="https://docs.example.com">Documentation</a> •
51	<a href="https://example.com">Website</a> •
52	<a href="https://discord.gg/invite">Discord</a>
53	</div>
54
55	---
56
57	## Why Project Name?
58
59	- Feature 1 — Brief explanation
60	- Feature 2 — Brief explanation
61	- Feature 3 — Brief explanation
62
63	## Quick Start
64
65	```bash
66	npm install project-name
67	```
68
69	```javascript
70	import { thing } from 'project-name';
71
72	const result = thing.doSomething();
73	console.log(result);
74	```
75
76	## Installation
77
78	### npm
79	```bash
80	npm install project-name
81	```
82
83	### yarn
84	```bash
85	yarn add project-name
86	```
87
88	### pnpm
89	```bash
90	pnpm add project-name
91	```
92
93	## Usage
94
95	### Basic Example
96
97	```javascript
98	// Code example with comments
99	```
100
101	### Advanced Example
102
103	```javascript
104	// More complex example
105	```
106
107	## Documentation
108
109	Full documentation available at [docs.example.com](https://docs.example.com)
110
111	- [Getting Started](https://docs.example.com/getting-started)
112	- [API Reference](https://docs.example.com/api)
113	- [Examples](https://docs.example.com/examples)
114
115	## Contributing
116
117	We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
118
119	## License
120
121	MIT © [Your Name](https://yoursite.com)
122	```
123
124	---
125
126	## Badges That Matter
127
128	### Trust Signal Badges
129
130	\| Badge \| What it shows \| When to use \|
131	\|-------\|--------------\|-------------\|
132	\| CI/Build status \| Code quality \| Always \|
133	\| Version \| Latest release \| Always for packages \|
134	\| License \| Legal clarity \| Always \|
135	\| Downloads/installs \| Adoption \| When impressive \|
136	\| Coverage \| Test quality \| If > 70% \|
137	\| Security \| Audit status \| If you have it \|
138
139	### Community Badges
140
141	\| Badge \| Source \| Purpose \|
142	\|-------\|--------\|---------\|
143	\| Discord members \| shields.io \| Show active community \|
144	\| GitHub stars \| shields.io \| Social proof \|
145	\| Contributors \| shields.io \| Open source health \|
146	\| Last commit \| shields.io \| Project activity \|
147
148	### Badge Services
149
150	\| Service \| URL \| Best for \|
151	\|---------\|-----\|----------\|
152	\| Shields.io \| shields.io \| Most badges \|
153	\| Badgen \| badgen.net \| Fast, minimal \|
154	\| GitHub badges \| Native \| Actions, issues \|
155
156	### Badge Examples
157
158	```markdown
159	<!-- Build status -->
160	![CI](https://github.com/org/repo/workflows/CI/badge.svg)
161
162	<!-- npm version -->
163	[![npm](https://img.shields.io/npm/v/package-name.svg)](https://www.npmjs.com/package/package-name)
164
165	<!-- Downloads -->
166	[![Downloads](https://img.shields.io/npm/dm/package-name.svg)](https://www.npmjs.com/package/package-name)
167
168	<!-- License -->
169	[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
170
171	<!-- Discord -->
172	[![Discord](https://img.shields.io/discord/SERVER_ID?color=7289da&logo=discord&logoColor=white)](https://discord.gg/invite)
173
174	<!-- Stars -->
175	[![GitHub sta

People who liked this also viewed

6 picks

Type