github-readme SKILL.md skillA

github-readme from thatrebeccarae/claude-marketing is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add thatrebeccarae/claude-marketing/github-readme@v2.0.0

Pins v2.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
thatrebeccarae/claude-marketing
Path
skills/github-readme/SKILL.md
Versions recorded
4
Latest version
v2.0.0, committed Mar 19, 2026
First version recorded
Mar 18, 2026
Size
11,745 bytes
Repository stars
176
License
MIT

Generate, audit, or update GitHub READMEs with project-type-aware structure, voice calibration, and SEO/AEO discoverability guidance. Three modes: generate (new), audit (check existing), update (patch). Detects repo type and adapts sections, tone, and badges accordingly.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# GitHub README Generator

Generate, audit, or update repository READMEs with project-type detection, voice calibration, discoverability guidance, and scored quality audits.

## Install

```bash
git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/github-readme ~/.claude/skills/
```

## When to Use

- Starting a new public repo and need a solid README from scratch
- Auditing an existing README for quality, discoverability, and security issues
- Updating a README after the repo has evolved (new deps, features, structure)
- Preparing a repo for public release and want discoverability optimized

## Modes

```
/github:readme generate [repo-path]   # Scan repo, detect type, generate README
/github:readme audit [repo-path]      # Score existing README (read-only, 0-100)
/github:readme update [repo-path]     # Re-scan, silent audit, patch with approval
```

Default `repo-path` is the current working directory if omitted.

---

## Step 0: Parse and Validate

Expect: `/github:readme {mode} [repo-path]`

1. **Extract mode** — `generate`, `audit`, or `update`. Any other value or missing → error with usage hint. STOP.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add thatrebeccarae/claude-marketing/github-readme@sha256:cc42f3d0f4143742

The line at the top of this page pins the label v2.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2staf3py5ao4hluo.svg)](https://markdownregistry.com/a/art_2staf3py5ao4hluo)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 18, 2026 and Mar 19, 2026, more than one a day.

versioncommittedcommitsizeaudit
v2.0.0 latest2026-03-19 28a1f95 11,745 BA view · diff
v1.0.02026-03-19 9f4f779 4,423 BA view · diff
v1.0.02026-03-18 13b4d57 4,417 BA view · diff
v1.0.02026-03-18 61c70b6 4,207 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11745 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

thatrebeccarae/claude-marketing · 176 stars · license MIT · pushed 2026-05-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2staf3py5ao4hluo
GET https://markdownregistry.com/api/v1/resolve?ref=thatrebeccarae/claude-marketing/github-readme
GET https://markdownregistry.com/api/v1/blob/cc42f3d0f414374257c8dcb43e0335bb82ba863954b27a797c805847e2c62c3f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from thatrebeccarae/claude-marketing

ab-testing-framework SKILL.md skill
thatrebeccarae/claude-marketing · skills/ab-testing-framework/SKILL.md · A/B and multivariate testing methodology. Design experiments, calculate sample sizes, determine statistical…
v1.0.0 · audit A · 176 stars
account-structure-review SKILL.md skill
thatrebeccarae/claude-marketing · skills/account-structure-review/SKILL.md · Google and Meta paid media account structure evaluation. Audits campaign/ad set architecture against conversion volume…
v1.0.0 · audit A · 176 stars
aeo-geo-optimizer SKILL.md skill
thatrebeccarae/claude-marketing · skills/aeo-geo-optimizer/SKILL.md · Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO) specialist. Optimize content and websites to…
v1.0.0 · audit A · 176 stars
brand-dna SKILL.md skill
thatrebeccarae/claude-marketing · skills/brand-dna/SKILL.md · Extract brand identity from a website URL — voice, colors, typography, imagery, values, and target audience — into a…
v1.0.0 · audit A · 176 stars
brand-voice-guidelines SKILL.md skill
thatrebeccarae/claude-marketing · skills/brand-voice-guidelines/SKILL.md · Develop brand voice, tone matrices, messaging frameworks, and brand book documentation. Use when the user asks about…
v1.0.0 · audit A · 176 stars
braze SKILL.md skill
thatrebeccarae/claude-marketing · skills/braze/SKILL.md · Braze customer engagement platform expertise. Audit campaigns, Canvases, segments, messaging channels, and data…
v1.0.0 · audit A · 176 stars
cold-email-outreach SKILL.md skill
thatrebeccarae/claude-marketing · skills/cold-email-outreach/SKILL.md · Cold email and outreach sequence design with personalization, deliverability optimization, follow-up cadence, and…
v1.0.0 · audit A · 176 stars
competitor-ads-analyst SKILL.md skill
thatrebeccarae/claude-marketing · skills/competitor-ads-analyst/SKILL.md · Extract and analyze competitor advertising from public ad libraries (Facebook Ad Library, Google Ads Transparency…
v1.0.0 · audit A · 176 stars
content-creator SKILL.md skill
thatrebeccarae/claude-marketing · skills/content-creator/SKILL.md · Comprehensive content marketing toolkit with brand voice analysis, SEO optimization scripts, content frameworks, social…
v1.0.0 · audit A · 176 stars
content-pipeline SKILL.md skill
thatrebeccarae/claude-marketing · skills/content-pipeline/SKILL.md · End-to-end content creation workflow that orchestrates research, editorial review, and social distribution agents in…
v1.0.0 · audit A · 176 stars
content-workflow SKILL.md skill
thatrebeccarae/claude-marketing · skills/content-workflow/SKILL.md · End-to-end content creation pipeline from research through editorial review to social distribution. Orchestrates a…
v1.0.0 · audit A · 176 stars
copywriting-frameworks SKILL.md skill
thatrebeccarae/claude-marketing · skills/copywriting-frameworks/SKILL.md · Framework-driven copywriting for ads, landing pages, emails, sales pages, and CTAs. Includes AIDA, PAS, BAB, 4Ps…
v1.0.0 · audit A · 176 stars

Every file in thatrebeccarae/claude-marketing

Other files named github-readme

github-readme SKILL.md skill
mickpletcher/ai-skills · generated/codex/skills/github-readme/SKILL.md · Write or repair an accurate, repository-specific README based on verified project files and requirements.
git:20261015.046d853 · audit A · 20 stars
github-readme SKILL.md skill
mickpletcher/ai-skills · claude/skills/github-readme/SKILL.md · Generate polished GitHub README.md files for Mick's repositories in his established voice and structure. Always trigger…
git:20260610.d1e991f · audit A · 20 stars
github-readme SKILL.md skill
mickpletcher/ai-skills · generated/claude/skills/github-readme/SKILL.md · Write or repair an accurate, repository-specific README based on verified project files and requirements.
git:20261015.046d853 · audit A · 20 stars
github-readme SKILL.md skill
mickpletcher/ai-skills · master-skills/github-readme/SKILL.md · Write or repair an accurate, repository-specific README based on verified project files and requirements.
git:20261015.1b4d9dc · audit A · 20 stars

Browse by kind, by grade A, or by owner.