Большинство README начинаются с терминологии и команд установки, скрывая суть проекта. Утилита beautify-github-readme сканирует репозиторий, выделяет главную ценность и перестраивает структуру страницы. Инструмент работает как AI-навык, опираясь только на реальный код.

Система строго разделяет визуальный и текстовый слои. Для заголовков, бейджей и диаграмм генерируются редактируемые SVG или опциональные GIF. Инструкции, конфигурации и консольные команды остаются в чистом Markdown. Страница не превращается в слепую картинку — текст остается доступным для поиска и копирования.

Скилл поддерживает два режима. Полная переработка меняет иерархию текста и добавляет графику. Визуальный стиль не использует готовые шаблоны, а генерируется на основе контекста самого проекта. Режим ассетов создает только графику, сохраняя исходный текст. Инструмент ставится через терминал командой npx skills add oil-oil/beautify-github-readme или прямым запросом к агенту.