oil-oil/beautify-github-readme

何を解決するか

多くのGitHubリポジトリには必要な情報はすべてありますが、その順序が混乱しており、訪問者がプロジェクトの核心的な価値を理解する前に、技術的なインストールコマンドやディレクトリ構造を目にすることが多いです。このプロジェクトは、プロジェクトの価値、実世界の例、使用範囲がすぐに明確になるように、READMEを再構成・設計するシステムを提供します。

動作方法

このツールはAIエージェントスキルとして動作し、リポジトリを分析して最も明確な価値と証拠を特定します。視覚的要素とコンテンツのレイヤーを分離することで、検索可能で保守しやすい状態を維持します：

• コンテンツレイヤー： 読み順を再編集し、重複を削除し、内部用語を具体的な成果に置き換えます（Markdown形式）。
• 視覚レイヤー： SVGを使用して編集可能なヘッダー、セクション遷移、図解を実現します。決定論的なSVGレイアウトとAI生成・背景除去済み画像を組み合わせた「ハイブリッド」コンポジションも作成可能です（自然な質感やキャラクターを表現）。
• エンジニアリングレイヤー： アセットがGitHub対応であることを保証し、画像のアクセシビリティを確保し、コマンドはコピー可能に保ちます。

対象ユーザー

READMEを長大で検索不能な画像に変えることなく、プロジェクトのホームページの明確さと視覚的アイデンティティを実際に改善したい開発者やオープンソースメンテナーアンです。

特徴

• 2つの動作モード： 「全README再設計」モード（コピーとビジュアルの完全刷新）と「アセットのみ」モード（ヘッダー、バッジなど特定のビジュアル要素の作成）を提供。
• プロジェクトネイティブデザイン： 一般的なテンプレートを避ける。代わりに、プロジェクトの本質（例：CLIツールはコマンドのリズム、研究リポジトリはチャート）から色、フォント、モチーフを導き出します。
• プロジェクト忠実： 実際のプロジェクト素材のみを使用し、能力を捏造したり、偽の推薦をしたりすることはありません。
• エージェント統合： npx でインストール可能、またはAIエージェントから直接リクエスト可能です。