AGENTIC-FIRST · COMPOSABLE · IMPRESSIVE

README cardsthat don't suck.

Drop a URL. Get a cinematic image. Paste in your README.

Works in any markdown. No signup. No config.

Start Generating
github.com/yerdaulet-damir
avatar@yerdaulet-damir
active
avatar bannerspotify now listening

## Projects

hacker cardcinematic card
USED BY DEVS AT@yerdaulet-damir@yourusernext@another-dev@ship-it-daily@0xbuilder

AGENTIC-FIRST ARCHITECTURE

Zero clicks. Just prompt.

We are built explicitly for modern LLM workflows. Feed our instructions endpoint to your AI assistant (ChatGPT, Claude, Cursor) and it will inject our cards perfectly into your markdown.

PROMPT YOUR AGENT

> "Hey Claude, update my GitHub README. Read the docs at https://coolreadme.xyz/llms.txt and make me a cinematic profile card for my username."

CARD STYLES

Every card you actually want.

Netflix. YouTube. X. AI. Drop any of them into your README.

netflix hero card
NETFLIX

Hero, continue watching, top 10. Three layouts, one URL.

youtube video card
YOUTUBE

Video, Shorts, or channel strip. Link your latest upload.

x twitter card
X / TWITTER

Pin a tweet. Engagement stats, verified badge, dark or light.

ai identity card
AI IDENTITYNEW

Claude, GPT, Cursor, Gemini. Show which model you actually use.

Or ship manually in 30 seconds.

01

Choose a style

Pick cinematic, avatar, brutalist, or project card.

02

Copy the URL

Swap your username and params. That's it.

03

Paste in README

One line of markdown. Your profile instantly levels up.

MARKDOWNcopy & paste
![avatar](https://coolreadme.xyz/api/avatar-card?user=yourname&status=SHIPPING)

Get your cards.

Enter your GitHub username and we'll assemble your setup.

FREQUENTLY ASKED QUESTIONS

Common questions

What is coolreadme.xyz?

A card generator for GitHub READMEs. Paste one markdown image tag, get a live-rendered card. No signup, no database, no config.

How do I add a card to my GitHub profile?

Create a repo named after your GitHub username, add a README.md, and drop in an image tag. It renders live on your profile page.

What cards are available?

  • Netflix Card — Hero, continue watching, top 10 layouts
  • YouTube Card — Video, Shorts, channel strip
  • X / Twitter Card — Pin a tweet with full engagement stats
  • Twitch Card — Stream, compact, or clip style
  • Steam Card — Library, store, or achievement layout
  • AI Identity Card — Claude, GPT, Cursor, Gemini, Grok
  • Avatar Card — GitHub avatar on a cinematic gradient
  • Cinematic Card — Dark status + focus display
  • Hacker Card — Terminal aesthetic
  • Social Card — Multi-platform social profile
  • Article Card — Blog post / dev.to style
  • Docs Card — Package readme / npm style

Is it free?

Yes. No signup, no API keys, no rate limits for personal use. Edge-rendered with aggressive caching — fast everywhere.

Can I use it with Claude or ChatGPT?

Yes. Point your agent at coolreadme.xyz/llms.txt and tell it your username. It will write the correct markdown for you.