mcpField
S
skill-doc-delivery

skill-doc-delivery

github.com/nyldnドキュメント4.3k58 回インストール今日更新
リポジトリ

skill-doc-delivery について

skill-doc-deliveryはCodex CLI向けのスキルで、ナレッジワークのMarkdownをオフィス文書に変換します。用途に応じた形式選びを案内し、document-skillsプラグインでDOCX、PPTX、PDFへ変換します。

主な機能

  1. 01MarkdownをDOCX、PPTX、PDFに変換
  2. 02納品目的に合わせた形式選択
  3. 03最近のワークフロー出力の検索
  4. 04文書スタイルのガイダンス
  5. 05プラグイン不足や形式未指定への対応

活用シーン

  1. 01研究成果を関係者向けに準備
  2. 02戦略分析をビジネスケースに整理
  3. 03文献レビューを出版向けに整形
  4. 04同じ原稿を複数形式で一括出力

インストール

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

$npx skills add https://github.com/nyldn/claude-octopus --skill skill-doc-delivery

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

同梱ファイルagents/openai.yaml

詳細

ホスト:Codex CLI — このスキルは Claude Code 向けに設計され、Codex 用に適応されています。 相互参照コマンドでは、/octo:* スラッシュコマンドではなく、Codex にインストールされたスキル名を使用します。 現在の Codex シェルとサブエージェントツールを使用してください。現在のセッションで利用可能であることが確認できるまでは、プロバイダー、モデル、ホストのサブエージェントが利用可能だと断言しないでください。 ホストツールの代替手段については、skills/blocks/codex-host-adapter.md を参照してください。

ナレッジワーカー向けドキュメントの作成

ナレッジワークの成果物を Markdown からプロフェッショナルなオフィス文書(DOCX、PPTX、XLSX)に変換します。

概要

このスキルを使うと、ナレッジワークの成果を洗練された納品用ドキュメントに変換できます。

  • 共感の後 → ペルソナを PPTX スライドに、要件を DOCX 仕様書にエクスポートします
  • 助言の後 → 戦略分析を PPTX プレゼンテーションまたは DOCX ビジネスケースに変換します
  • 統合の後 → 文献レビューを DOCX の学術形式または PDF で作成します

前提条件の確認

ドキュメントを変換する前に、document-skills プラグインがインストールされていることを確認してください。

/plugin list | grep document-skills

インストールされていない場合:

/plugin install document-skills@anthropic-agent-skills

ワークフロー別の形式の推奨

共感ワークフロー → UX リサーチの成果物

PPTX(PowerPoint)に最適:

  • ステークホルダー向けプレゼンテーション用のペルソナスライド
  • ジャーニーマップのビジュアライゼーション
  • リサーチの統合結果の要点
  • エグゼクティブサマリー

DOCX(Word)に最適:

  • 詳細なペルソナのドキュメント
  • リサーチ要件の仕様書
  • インタビューの書き起こしと分析
  • ユーザーストーリーのドキュメント
助言ワークフロー → 戦略分析

PPTX(PowerPoint)に最適:

  • 経営陣向けの戦略プレゼンテーション
  • 市場分析スライド
  • 競合情報のブリーフィング
  • ビジネスケースの提案資料
  • 取締役会向けプレゼンテーション

DOCX(Word)に最適:

  • 包括的なビジネスケース
  • 戦略提言レポート
  • 市場調査のドキュメント
  • 財務分析レポート
統合ワークフロー → リサーチの統合

DOCX(Word)に最適:

  • 文献レビュー論文
  • リサーチ統合レポート
  • 学術研究のドキュメント
  • 注釈付き参考文献
  • 技術白書

PDF に最適:

  • 最終出版物
  • アーカイブ用バージョン
  • 共有可能なリサーチレポート

変換ガイドライン

ステップ 1:ソース Markdown の場所を確認する

ナレッジワークの成果物は次の場所に保存されています:

~/.claude-octopus/results/

最近の成果物を一覧表示します:

ls -lht ~/.claude-octopus/results/ | head -10
ステップ 2:目的に応じて形式を選ぶ

次の点を自問してください。

  • ステークホルダーにプレゼンテーションしますか? → PPTX(視覚的で簡潔)
  • 包括的なドキュメントが必要ですか? → DOCX(詳細で構成が明確)
  • 最終出版物ですか? → PDF(アーカイブ向けで変更不可)
  • データ/フレームワークですか? → XLSX(表、計算)
ステップ 3:Document-Skills プラグインを使用する

document-skills プラグインでは、次の機能を利用できます。

DOCX(Word)向け:

Use the /document-skills:docx skill to convert markdown to Word format.
Supports headings, lists, tables, and formatting.

PPTX(PowerPoint)向け:

Use the /document-skills:pptx skill to convert markdown to PowerPoint.
Each ## heading becomes a slide, bullet points auto-format.

PDF 向け:

Use the /document-skills:pdf skill to generate PDF documents.
Ideal for final deliverables and archival.
ステップ 4:プロフェッショナルなスタイルを適用する

変換後は、次の点を検討してください。

  • 一貫した書式 - 見出しスタイルと箇条書きの階層を使用する
  • 視覚的な階層 - 重要なポイントを先に、詳細を後に配置する
  • ブランドとの整合性 - 必要に応じてロゴ、色、フォントを追加する
  • 読みやすさ - 長い段落を分割し、余白を活用する

よくある変換パターン

パターン 1:単一のワークフロー → 単一のドキュメント

ユーザーが 1 つのワークフローを実行し、1 つのドキュメントを希望する場合:

User: "Export my latest synthesis to a Word document"

1. Check ~/.claude-octopus/results/ for most recent .md file
2. Identify it's from synthesize workflow
3. Recommend DOCX for academic report format
4. Use document-skills:docx to convert
5. Save to appropriate location
パターン 2:複数のセクション → プレゼンテーション

ユーザーがリサーチからスライドを作成したい場合:

User: "Create a PowerPoint from this research"

1. Locate the research markdown
2. Identify key sections (## headings)
3. Use document-skills:pptx to convert
4. Each ## heading becomes a slide
5. Recommend adding title slide and summary
パターン 3:一括変換

ユーザーが複数の形式を希望する場合:

User: "Create both a Word doc and PowerPoint from this strategy"

1. Locate source markdown
2. Convert to DOCX using document-skills:docx
3. Convert to PPTX using document-skills:pptx
4. Provide both file paths

プロフェッショナルなスタイル設定のヒント

DOCX(Word)のベストプラクティス
  • 組み込みの見出しスタイル(見出し 1、見出し 2 など)を使用する
  • 5 ページを超えるドキュメントには目次を追加する
  • 箇条書きと番号付きリストを適切に使用する
  • ページ番号とヘッダー/フッターを含める
  • 冒頭にエグゼクティブサマリーを追加する
  • 構造化データには表を使用する
PPTX (PowerPoint) のベストプラクティス
  • スライドごとに 1 つの主要なアイデア
  • 著者/日付を含むタイトルスライドを使用する
  • スライドごとに箇条書きは最大 5~7 項目
  • 一貫したフォントと色を使用する
  • スライド番号を追加する
  • まとめ/次のステップのスライドを含める
  • 可能な限りビジュアルを使用する (グラフ、図)
PDF のベストプラクティス
  • 最終レビュー後に DOCX から変換する
  • すべてのフォントが埋め込まれていることを確認する
  • 画面表示用または印刷用に最適化する
  • メタデータ (タイトル、著者、キーワード) を追加する
  • ナビゲーション用にブックマークを使用する

ワークフローの例

例 1: UX リサーチペルソナデック
Input: ~/.claude-octopus/results/empathize-session-2026-01-18.md

Output Goal: Stakeholder presentation

Steps:
1. Read the empathize markdown
2. Extract persona sections
3. Convert to PPTX using document-skills:pptx
4. Each persona becomes a slide
5. Add title slide and key insights summary
6. Save as "UX-Personas-2026-01-18.pptx"
例 2: 戦略的ビジネスケース
Input: ~/.claude-octopus/results/advise-market-analysis-2026-01-18.md

Output Goal: Comprehensive business case document

Steps:
1. Read the advise markdown
2. Structure as: Executive Summary, Analysis, Recommendations, Appendix
3. Convert to DOCX using document-skills:docx
4. Add table of contents
5. Format tables and charts properly
6. Save as "Market-Analysis-Business-Case-2026-01-18.docx"
例 3: 文献レビュー論文
Input: ~/.claude-octopus/results/synthesize-ai-safety-2026-01-18.md

Output Goal: Academic paper format

Steps:
1. Read the synthesize markdown
2. Structure as: Abstract, Introduction, Literature Review, Gaps, Conclusions
3. Convert to DOCX using document-skills:docx
4. Apply academic formatting (citations, references)
5. Export to PDF for final version
6. Save as "AI-Safety-Literature-Review-2026-01-18.pdf"

エッジケースの処理

最近のワークフロー出力がない場合

ユーザーがエクスポートを要求したが、ワークフローが実行されていない場合:

Response: "I don't see any recent knowledge work outputs. Would you like to run:
- /octo:empathize (UX research)
- /octo:advise (strategic analysis)
- /octo:synthesize (literature review)

Then I can convert the results to your preferred format."
形式が指定されていない場合

ユーザーが形式を指定していない場合:

Response: "I can convert this to:
- DOCX (Word) - Best for detailed documentation
- PPTX (PowerPoint) - Best for presentations
- PDF - Best for final deliverables

Which format would you prefer based on your use case?"
複数の Markdown ファイルがある場合

複数の出力が存在する場合:

Response: "I found several knowledge work outputs:
1. empathize-personas-2026-01-15.md (3 days ago)
2. advise-market-analysis-2026-01-18.md (today)
3. synthesize-research-2026-01-10.md (8 days ago)

Which would you like to convert?"
Document-Skills がインストールされていない場合

プラグインが存在しない場合:

Response: "The document-skills plugin is required for conversion.
Install it with:

/plugin install document-skills@anthropic-agent-skills

Then I can convert your knowledge work to office formats."

ナレッジモードとの統合

このスキルは、3 つのナレッジモードワークフローとシームレスに連携するように設計されています:

Knowledge Work Flow:
1. Run workflow: /octo:empathize (or advise/synthesize)
2. Review markdown output in ~/.claude-octopus/results/
3. Request conversion: "Export to PowerPoint"
4. This skill is used after explicit invocation
5. Professional document delivered

ベストプラクティス

  1. 変換前にレビューする - まず Markdown の品質を確認します
  2. 適切な形式を選ぶ - 対象読者と目的に形式を合わせます
  3. コンテキストを追加する - 日付、著者、バージョン番号を含めます
  4. 互換性をテストする - 受け取る人がその形式を開けることを確認します
  5. ソースをアーカイブする - 元の Markdown ファイルを保持します
  6. バージョン管理 - 日付を含む説明的なファイル名を使用します

クイックリファレンスコマンド

# List recent knowledge work outputs
ls -lht ~/.claude-octopus/results/ | head -5

# Check document-skills installed
/plugin list | grep document-skills

# Install document-skills
/plugin install document-skills@anthropic-agent-skills

# View specific markdown
cat ~/.claude-octopus/results/[filename].md

ヘルプの入手

以下に関する質問について:

  • ドキュメント変換 → 具体的な形式のニーズについて質問してください
  • ナレッジワークフロー → /octo:knowledge-mode を参照してください
  • Document-Skills の機能 → /document-skills:* スキルを参照してください
  • スタイリングとフォーマット → 形式ごとのベストプラクティスを質問してください

claude-octopus v7.3.0+ 向けのドキュメント配信スキル

コメント