Readme Showcase

Turn a repository's README.md into an attractive, engaging showcase with a hero banner, badges, real screenshots, demo GIFs, embedded videos, feature grids, a quick start and a polished layout. Use when asked to write, rewrite, improve, beautify or "make attractive" a README, add screenshots/GIFs/demo videos to a README, or prepare a repo for launch or sharing.

9 stars 2 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add satiricalguru/Agents-skills --skill readme-showcase
Manual install
git clone --depth 1 https://github.com/satiricalguru/Agents-skills.git /tmp/Agents-skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agents-skills/skills/readme-showcase ~/.claude/skills/readme-showcase

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# README Showcase

Make a README that sells the project in five seconds and gets someone running it in five minutes. Everything in it must be **true for this repo**: real screenshots of the real app, commands that actually work and features that actually exist.

Works with any agent that can read files and run shell commands (Claude Code, Codex, Gemini CLI, OpenCode, Cursor and others).

## Workflow

### 1. Understand the project (don't write yet)
- Read the existing README, the package manifest (`package.json`, `pyproject.toml`, `Cargo.toml`, `*.xcodeproj`, `go.mod`), the entry points, `.github/workflows`, `LICENSE`, and the existing `docs/` and `assets/` folders.
- Find out: what it does, who it's for, what makes it different, the platforms it runs on, how to install and run it, and whether it has a UI, a CLI or is a library.
- Get repo facts with `git remote -v` and, if `gh` is available, `gh repo view --json name,description,homepageUrl,licenseInfo,repositoryTopics,stargazerCount`.
- Keep any content worth saving: license, credits, citations and contributor notes.

### 2. Capture visuals (the most important step)
Store all media in `assets/` (or the existing `docs/images`/`.github/assets`). Use lowercase kebab-case names: `hero.png`, `demo.gif`, `feature-search.png`.

| Project type | What to capture | How |
|:--|:--|:--|
| Web app / site | Hero screenshot, 2–4 feature screens, a 5–15 s demo GIF | Start the dev server, then `scripts/screenshot.mjs` (Playwright) |
Read the full skill on GitHub

Details

Skill name
readme-showcase
Path
skills/readme-showcase/SKILL.md
License
MIT
Repo updated
6 November 2026

FAQ

What does the Readme Showcase skill do?

Turn a repository's README.md into an attractive, engaging showcase with a hero banner, badges, real screenshots, demo GIFs, embedded videos, feature grids, a quick start and a polished layout. Use when asked to write, rewrite, improve, beautify or "make attractive" a README, add screenshots/GIFs/demo videos to a README, or prepare a repo for launch or sharing.

How do I install the Readme Showcase skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add satiricalguru/Agents-skills --skill readme-showcase. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Readme Showcase popular?

It lives in satiricalguru/Agents-skills, which has 9 GitHub stars and 2 forks.

Related skills

Sota Animated Landing Page

9

satiricalguru/Agents-skills

Research and build art-directed landing pages with reference-matched imagery, expressive typography, cinematic scroll sequences, responsive layouts, and visual verification. Use for landing-page creation or substantial redesign while preserving the existing product and the user's chosen visual direction.

Frontend & Design

Stageshow

9

satiricalguru/Agents-skills

Build faux product UI that looks like a real product, as a still illustration or an animated demo with a cursor. Browser and app windows, dashboards, phones, notifications, terminals, bento grids and cursor walkthroughs, framed, masked and cropped the way a marketing page, feature card or docs hero needs them. Use whenever someone wants a fake or mocked UI, a product demo or walkthrough animation, a hero or feature-card illustration of an app, a product shot in the style of a polished marketing site, or an animated cursor doing things in an interface, even if they never say "faux UI". React an

Frontend & Design

Section Drafter

10

gener8v/gener8v.claude-skills.rfp-response

Writes one markdown file per RFP response section, grounded in the coverage matrix and collateral brief. Every claim is either traced to a source or flagged as an assertion. Trigger when the user says "draft the sections," "write the response," "start drafting," or after the requirements mapper has produced coverage-matrix.md. Can also be triggered for a single section: "draft the technical approach" or "write the security section.

Writing & Content

Grill with Docs

4

IvDev19/skill-grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

Writing & ContentIn 1 list

Case Law to Content

10

thicazu-png/claude-skills-advocacia

Transforma acórdãos, ementas, decisões judiciais, notícias jurídicas e teses jurisprudenciais em conteúdo digital para advogados, empresas e público jurídico. Use para criar posts, artigos, newsletters, roteiros, carrosséis e alertas com contexto, limites do precedente, impacto prático e cautela técnica.

Writing & Content

Proof Engine

9

yaniv-golan/proof-engine

Create formal, verifiable proofs of claims with machine-checkable reasoning. Use when asked to prove, verify, fact-check, or rigorously establish whether a claim is true or false — mathematical, empirical, or mixed. Trigger phrases: "is it really true", "can you prove", "verify this", "fact-check this", "prove it", "show me the logic". Do NOT use for opinions, essays, or questions with no verifiable answer.

Writing & Content

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.