markdown-viewer/skills

解決する課題

このプロジェクトは、AIエージェント（Claude Code、Cursor、GitHub Copilotなど）が、アーキテクチャ図、チャート、インフォグラフィックなどの高品質でプロフェッショナルなビジュアルをMarkdown内で直接生成するための「スキル」セットを提供します。エージェントのテキスト作成能力と、特定のレンダリングエンジンを使用して構造化された視覚的ドキュメントを作成する能力との間のギャップを埋めるものです。

仕組み

このプロジェクトは、Agent Skillsフォーマットに従ったスキルパッケージ (documd-visuals) として構成されています。これはルーターとして機能し、AIエージェントを31の異なる目標ドメイン（ソフトウェア設計、クラウドアーキテクチャ、ビジネスレポートなど）と183のシナリオに導きます。

エージェントがリクエストを受け取ると、SKILL.md ルーターを使用してユーザーの意図を特定の目標ドメインと照合し、シナリオに基づいて適切なレンダリングエンジンを選択します：

• PlantUML/puml: UML、ArchiMate、BPMN、およびネットワーク/セキュリティアーキテクチャ用。
• Vega/Vega-Lite: 統計変換を伴うデータ駆動型チャート用。
• ECharts: レポートグレードのダッシュボードおよびゲージ用。
• Infographic: テンプレート駆動型のロードマップおよび比較用。
• HTML/CSS: システムアーキテクチャ図およびページレイアウト用。

また、これらのMarkdownベースのビジュアルをPDF、DOCX、SVGなどの完成ファイルにエクスポートするためのオプションの documd CLIツールも利用可能です。

対象ユーザー

• AIエージェントユーザー: コーディングエージェントを使用して技術ドキュメントを生成する方。
• テクニカルライター: バージョン管理を容易にするために、ビジュアルをMarkdown内のテキストとして維持したい方。
• 開発者: AIを介して複雑なシステム図やアーキテクチャマップを迅速に生成する必要があるエンジニア。

ハイライト

• 広範なライブラリ: 31の目標ドメインにわたる242の検証済み例が含まれています。
• エージェント対応: npx skills add を介してAIコーディングエージェントと統合するように特別に設計されています。
• マルチエンジンサポート: UMLからインフォグラフィックまでをカバーする5つの異なるレンダリングエンジンを統合しています。
• テーマ別スタイリング: 視覚的な一貫性とコントラストを確保するために、9つの異なるテーマをサポートしています。
• エクスポート機能: Markdownビジュアルをプロフェッショナルなドキュメント形式に変換するためのCLIを提供します。