mcpField
E
elegant-reports

elegant-reports

github.com/jdrhyneドキュメント240256 回インストール9 週間前に更新
リポジトリ

elegant-reports について

elegant-reportsは、北欧風のミニマルなPDFレポートをMarkdownから生成するスキルです。再利用可能なテンプレートとテーマを備え、経営向けブリーフィングや分析レポート、スライド風文書の作成に使えます。

主な機能

  1. 01MarkdownからPDFを生成
  2. 02ブリーフィング、レポート、プレゼン用テンプレート
  3. 03対応テンプレートのライト・ダークテーマ
  4. 04YAMLフロントマターによる出力設定
  5. 05レイアウト確認用のHTML出力

活用シーン

  1. 01経営向けブリーフィングや取締役会資料の作成
  2. 02Markdownの分析内容をPDF化
  3. 031ページに1つの要点を置くプレゼン資料の生成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jdrhyne/agent-skills --skill elegant-reports

インストール後、Claude Code で/elegant-reportsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
generate.js
NORDIC_DESIGN_RESEARCH.md
package-lock.json
package.json
examples/
sample-executive.md
sample-output.html
references/
nordic-design-research.md
scripts/
smoke-test.js
templates/
analysis.html
executive-v2.html
executive.html
metrics.html
notes.html
presentation-dynamic.html
report-dynamic.html
report-v2.html
themes/
nordic-dark.css
nordic-light.css
nordic-report-dark.css
nordic-report.css
nordic-v2.css

詳細

elegant-reports

スカンジナビアのエディトリアルデザインに着想を得た、ミニマルな PDF レポートを生成します。

使用する場面

ユーザーが次のようなものを求めている場合に、このスキルを使用します。

  • 洗練された経営陣向けブリーフィングや取締役会向けレポート
  • Markdown から生成する、プレゼンテーションのような PDF
  • デフォルトの開発者向けスタイルではなく、すっきりとした北欧のビジュアル表現
  • 慎重に拡張できる、再利用可能なレポートテンプレートシステム

クイックスタート

package-lock.json に固定された依存関係をインストールしてから、次を実行します。

cd /path/to/elegant-reports
node ./generate.js --list
node ./generate.js examples/sample-executive.md output.pdf --template executive --theme light

HTML のデバッグでは、--output-html を追加すると、生成された HTML が PDF と一緒に保存されます。

利用可能なテンプレート

テンプレート用途
executive洗練されたブリーフィングや簡潔な経営陣向け要約
report情報量の多い叙述形式のレポートや分析文書
presentation1 ページにつき 1 つのアイデアを示す、力強いスライド風の出力
report-demo比較・テスト用の旧式レポートバリエーション
presentation-demo比較・テスト用の旧式プレゼンテーションバリエーション

各テンプレートでは、対応している場合、light と dark のテーマを利用できます。

フロントマター

レンダリング結果を制御するには、YAML フロントマターを追加します。

---
title: Q4 Competitive Analysis
subtitle: Market Intelligence Report
author: Report Author
template: report
theme: dark
---

Your content here...

ワークフロー

  1. 最初から作成するのではなく、既存のテンプレートから最も近いものを選びます。
  2. ソースの Markdown を作成または調整します。
  3. PDF を生成します。
  4. レイアウトの調整が必要な場合は、--output-html で出力された HTML を確認し、対応するテンプレートとテーマの組み合わせを調整します。
  5. デザインが整い、PDF が安定するまで再実行します。

スキルの拡張

新しいビジュアルバリエーションを作成する場合：

  • 同梱されているテンプレートとテーマから、最も近いものをベースにします
  • トークン名と間隔の尺度を、既存のシステムと一貫させます
  • 一度に変更するビジュアル要素は 1 つだけにし、変更のたびに再生成します
  • デザイン言語全体を書き直すのではなく、既存のものに追加するバリエーションを優先します
  • 置き換えが検証されるまで、旧式のテンプレートやデモ用テンプレートを利用できる状態にしておきます

同梱されている北欧デザインの調査メモは、ビジュアルシステムの公式な参照資料です。デザインの根拠を詳しく知る必要がある場合にのみ読みます。

安全上の境界

  • ユーザーが Nutrient DWS を通じた PDF 生成を明示的に依頼し、ネットワーク境界を受け入れていない限り、機密性の高いソース文書をサードパーティのサービスに送信しないでください。
  • 任意のローカルファイルを参照しないでください。読み取り対象は、スキルのバンドルと、ユーザーが承認した入力・出力パスに限定してください。
  • ユーザーが承認した作業ディレクトリの外にあるファイルを上書きまたは削除しないでください。
  • ユーザーがそのセットアップ作業を明示的に依頼しない限り、追加のパッケージをインストールしたり、依存関係のバージョンを変更したり、新しい外部サービスを追加したりしないでください。
  • 出力成果物が存在し、生成処理がエラーなく完了していない限り、レポートの生成に成功したと主張しないでください。
  • ユーザーが新たなビジュアル調査を明示的に希望しない限り、外部のデザイン例やウェブ上の参考資料を取得しないでください。

依存関係

  • Node.js 18+
  • package-lock.json に固定された npm 依存関係
  • PDF 生成用の NUTRIENT_DWS_API_KEY 環境変数

ファイル一覧

  • メインのジェネレーター CLI とモジュールのエントリーポイント
  • 同梱の HTML テンプレート
  • 同梱のビジュアルテーマ
  • Markdown のサンプル入力
  • スキルに同梱された、必要に応じて参照する詳細なデザインの根拠

検証

スキルの作業を完了とする前に：

  • node ./generate.js --list を実行します
  • npm test を実行します
  • 指定された出力パスに、想定される PDF または HTML の成果物が存在することを確認します

コメント

Markdown 対応