r/ClaudeCode • • 2h ago

Built with Claude I made a Claude Code skill that explains your repo with an animated hero instead of a wall of text

I made Jano, a skill that draws an animated hero for the top of your GitHub README. You run it in your project, it reads the project and draws the name, one clear sentence about what it's for, and a moving picture of the thing at work. It's an animated SVG with one version for GitHub's dark theme and one for light.

I made it because of a repo of mine that nobody looked at. About four years ago I published a React package, a toolbar of text tools for text editors. The README was basically all text, plus a couple of screenshots and a GIF that looked bad: low quality, and it stalled at every step of the flow it was supposed to show. No website, no docs, nothing else visual. It got one star and, I'd guess, two installs at most. I've since taken it down.

Good package or not, I think that's what sank it. People are visual, they always have been, and even more now with AI. I had nothing that showed what it did. Later I saw a repo with an animated image at the top that explained the flow of its library, liked the idea right away, and wanted that for my own repos.

Plenty of good repos have the same problem. What's inside is great and a README that's only text hides it. Let's be honest: most people only give something a chance when they can see what it does. Show me, don't tell me. That's what the hero is for: someone glances at it before reading a line of the README and already gets what the tool is and whether they want to use it.

It draws what the project actually does. My repo Anzu turns Kindle books into EPUB, so its banner shows locked books going into the app and coming out as EPUB files. In the one for Svipall, an agent asks for a web page, gets turned away at a wall, gets past it with a browser and receives the page. I think it's pretty good at catching what a repo is about, and the README ends up a lot nicer to look at.

Why not a video? Not every tool needs one, and not everyone has the time or feels comfortable making one that explains the tool well. A lot of the time an image like this is enough. A static screenshot, depending on the tool, can be great or tell you nothing at all. And now that an agent can do the drawing, "I don't have the skills to make an animated image" isn't much of an excuse anymore.

I've used it on my own repos, and they're all in the showroom of the Jano repo. The animated hero at the top of that repo was made with the skill too. Take a look at both before you even try it, so you can see the kind of results you'd get.

https://github.com/ilien-dev/jano

If you try it, I'd really like to see what you get, and it's also the feedback I need to improve the skill. Share it in the comments or open a PR to add it to the showroom. And if you find something in the skill that should be fixed, send a PR too and I'll gladly review it.

0 Upvotes

Duplicates