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.
Install
npx skills add satiricalguru/Agents-skills --skill readme-showcasegit 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-showcasePersonal 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) |
Details
- Skill name
readme-showcase- Repository
- satiricalguru/Agents-skills
- 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
9satiricalguru/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.
Stageshow
9satiricalguru/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
Section Drafter
10gener8v/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.
Grill with Docs
4IvDev19/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.
Case Law to Content
10thicazu-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.
Proof Engine
9yaniv-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.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.