zyphraxns

Readme Visual Design — Security skill for Claude Code

Security community

Agent skill for revamping a GitHub README.

How to install Readme Visual Design

This entry records only its repository, not the path inside it, so there is no exact command to give. Open zyphraxns/readme-visual-design and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Readme Visual Design does

Agent skill for revamping a GitHub README. Ships an audit script and a before/after first-screen preview, so the revamp is verifiable instead of a matter of taste.

Alternatives in Security

Axton Obsidian Visual Skills — Trail of Bits Claude Code skills for security research, vulnerability detection, and audit workflows 3.7k ★
Agent Skills Guard — 一款提供Agent Skills安全扫描和可视化管理的桌面应用 A desktop application that provides security scanning and visual management fo 389 ★
Brand Strategy — Define or audit a brand — positioning, visual identity system, voice and tone, and brand architecture 309 ★

README

README Visual Design

An agent skill that revamps the opening screen of a GitHub README.
It ships the two things most README skills don't: an audit that catches broken output, and a preview that lets you see the result before you push.

Left: four mismatched badges and a three-paragraph disclaimer fill the opening screen. Right: the title, a one-line pitch and the tool's terminal output, with badges below.
Generated by running the two scripts on examples/envdiff — a made-up CLI project, not a real one.

Why · Paradigms · Audit · Install · Limits

Why another README skill

Most of them are a pile of prompts: center the title, add badges, fold the long sections. None of them can tell you whether the badge URL you just generated actually resolves, whether the image path survives a rename, or whether the "after" is genuinely better than the "before". You find out after pushing.

This one carries two tools, both plain Python with no dependencies:

Tool	What it does
`scripts/check_readme.py`	Rule-based audit: broken image paths, empty `#` links, malformed shields.io URLs, dead in-page anchors, heading level jumps, malformed alerts, unclosed , table column drift, oversized images. It also prints the order of elements on the opening screen — the fact the diagnosis depends on.
`scripts/preview_firstscreen.py