文档安装
- 作者仓库星标 3,406
- 作者更新于 实时读取
- 作者仓库 claude-octopus
- 领域
- 文档
- 兼容 Agent
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- 信任分
- 88 / 100 · 社区维护
- 作者 / 版本 / 许可
- @nyldn · 未声明 license
- Token 消耗评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部 API Key
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 底层运行要求
- 无特殊要求
- 文件与系统权限
-
- 只读
- 允许写入 / 修改
- Shell 执行
- 网络行为
- 仅限本地
- 安装命令数
- 26 条
档案由构建时根据 SKILL.md 与安装命令自动衍生,可能与作者实际意图存在差异。
需要注意: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skill-doc-delivery
description: Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable delive…
category: 文档
runtime: 无特殊运行时
---
# skill-doc-delivery 输出预览
## PART A: 任务判断
- 适用问题:PRD、RFC、README、项目说明或知识库整理。
- 输入要求:目标材料、限制条件、期望输出和验收方式。
- 证据边界:围绕“Overview / Prerequisites Check / Format Recommendations by Workflow”读取原文规则,不把推断写成作者承诺。
## PART B: 执行结果
- **01** 任务判断:确认你的需求是否属于PRD、RFC、README、项目说明或知识库整理,并标出输入、限制和预期结果。
- **02** 执行计划:优先按“Overview / Prerequisites Check / Format Recommendations by Workflow”拆成步骤,说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果:给出可复制的命令、文件改动、检查清单或内容草稿,并说明如何继续迭代。
- **04** 风险边界:结合 读取文件、写入/修改文件、执行终端命令、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。
## Running Rules
- 读取文件、写入/修改文件、执行终端命令;主要在本地完成;通常不需要额外 API Key。
- 先小样例验证,再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。 原文出现了 `/octo`、`/plugin`、`/document-skills` 这类斜杠命令;如果你的 Agent 支持命令触发,优先用命令开场,再补充目标和边界。
告诉 Agent 目标文件或材料、期望结果、不可改范围、是否允许联网或执行命令。本 Skill 的权限画像是:读取文件、写入/修改文件、执行终端命令。
先用一个小任务确认它会围绕“Overview / Prerequisites Check / Format Recommendations by Workflow”工作;涉及文件或命令时,先看 diff、日志、预览或测试结果。
检查最终产物是否包含明确结果、必要证据和下一步动作;如果输出泛泛而谈,就补充输入、边界和验收标准后重跑。
---
name: skill-doc-delivery
description: Convert markdown to DOCX, PPTX, XLSX, PDF office documents — use when you need exportable delive…
category: 文档
source: nyldn/claude-octopus
---
# skill-doc-delivery
## 什么时候使用
- 把项目文档方向的常用动作沉淀成 Agent 可调用的技能 适合处理README、PRD、RFC、教程和知识库文档,核心价值是把输入、判断、执行、验证和交付边界固定下来,避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的…
- 面向PRD、RFC、README、项目说明或知识库整理,优先处理能明确输入、步骤和验收标准的工作。
## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。
## 执行规则
- 围绕「Overview / Prerequisites Check / Format Recommendations by Workflow」组织步骤,不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令;主要在本地完成;通常不需要额外 API Key。
- 先跑小样例,确认结果可检查后再扩大任务范围。
## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown,不编造命令、平台或依赖。 作者原文负责流程事实;仓库文件负责来源和命令;流狐只补充适用场景、限制和质量判断。
skill "skill-doc-delivery" {
输入层 -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
上下文层 -> Overview / Prerequisites Check / Format Recommendations by Workflow
规则层 -> SKILL.md 触发条件 / 执行顺序 / 输出格式
运行层 -> 无特殊运行时 | 读取文件、写入/修改文件、执行终端命令 | 主要在本地完成
安全层 -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
输出层 -> 可复制结果 + 检查清单 + 下一步迭代
} Host: Codex CLI — This skill was designed for Claude Code and adapted for Codex. Cross-reference commands use installed skill names in Codex rather than
/octo:*slash commands. Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it. For host tool equivalents, seeskills/blocks/codex-host-adapter.md.
Document Delivery for Knowledge Workers
Convert knowledge work outputs from markdown to professional office documents (DOCX, PPTX, XLSX).
Overview
This skill helps you transform knowledge work results into polished, deliverable documents:
- After empathize → Export personas to PPTX decks or requirements to DOCX specs
- After advise → Convert strategic analysis to PPTX presentations or DOCX business cases
- After synthesize → Generate literature reviews as DOCX academic format or PDF
Prerequisites Check
Before converting documents, verify the document-skills plugin is installed:
/plugin list | grep document-skills
If not installed:
/plugin install document-skills@anthropic-agent-skills
Format Recommendations by Workflow
Empathize Workflow → UX Research Outputs
Best for PPTX (PowerPoint):
- Persona decks for stakeholder presentations
- Journey map visualizations
- Research synthesis highlights
- Executive summaries
Best for DOCX (Word):
- Detailed persona documentation
- Research requirements specifications
- Interview transcripts and analysis
- User story documentation
Advise Workflow → Strategic Analysis
Best for PPTX (PowerPoint):
- Strategy presentations for leadership
- Market analysis decks
- Competitive intelligence briefs
- Business case pitch decks
- Board presentations
Best for DOCX (Word):
- Comprehensive business cases
- Strategic recommendations reports
- Market research documentation
- Financial analysis reports
Synthesize Workflow → Research Synthesis
Best for DOCX (Word):
- Literature review papers
- Research synthesis reports
- Academic research documentation
- Annotated bibliographies
- Technical white papers
Best for PDF:
- Final publications
- Archival versions
- Shareable research reports
Conversion Guidelines
Step 1: Locate Source Markdown
Knowledge work outputs are stored in:
~/.claude-octopus/results/
List recent outputs:
ls -lht ~/.claude-octopus/results/ | head -10
Step 2: Choose Format Based on Purpose
Ask yourself:
- Presenting to stakeholders? → PPTX (visual, concise)
- Comprehensive documentation? → DOCX (detailed, structured)
- Final publication? → PDF (archival, unchangeable)
- Data/frameworks? → XLSX (tables, calculations)
Step 3: Use Document-Skills Plugin
The document-skills plugin provides these capabilities:
For DOCX (Word):
Use the /document-skills:docx skill to convert markdown to Word format.
Supports headings, lists, tables, and formatting.
For PPTX (PowerPoint):
Use the /document-skills:pptx skill to convert markdown to PowerPoint.
Each ## heading becomes a slide, bullet points auto-format.
For PDF:
Use the /document-skills:pdf skill to generate PDF documents.
Ideal for final deliverables and archival.
Step 4: Apply Professional Styling
After conversion, consider:
- Consistent formatting - Use heading styles, bullet hierarchies
- Visual hierarchy - Important points first, details later
- Brand alignment - Add logos, colors, fonts if needed
- Readability - Break up long paragraphs, use white space
Common Conversion Patterns
Pattern 1: Single Workflow → Single Document
User ran one workflow, wants one document:
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
Pattern 2: Multiple Sections → Presentation
User wants to create a deck from research:
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
Pattern 3: Batch Conversion
User wants multiple formats:
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
Professional Styling Tips
DOCX (Word) Best Practices
- Use built-in heading styles (Heading 1, Heading 2, etc.)
- Add table of contents for documents >5 pages
- Use bullet points and numbered lists appropriately
- Include page numbers and headers/footers
- Add executive summary at the beginning
- Use tables for structured data
PPTX (PowerPoint) Best Practices
- One main idea per slide
- Use title slide with author/date
- 5-7 bullet points max per slide
- Use consistent fonts and colors
- Add slide numbers
- Include summary/next steps slide
- Use visuals where possible (charts, diagrams)
PDF Best Practices
- Convert from DOCX after final review
- Ensure all fonts are embedded
- Optimize for screen or print
- Add metadata (title, author, keywords)
- Use bookmarks for navigation
Example Workflows
Example 1: UX Research Persona Deck
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"
Example 2: Strategic Business Case
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"
Example 3: Literature Review Paper
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"
Handling Edge Cases
No Recent Workflow Output
If user requests export but no workflow was run:
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."
Format Not Specified
If user doesn't specify 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?"
Multiple Markdown Files
If multiple outputs exist:
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 Not Installed
If plugin missing:
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."
Integration with Knowledge Mode
This skill is designed to work seamlessly with the three knowledge mode workflows:
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 activates automatically
5. Professional document delivered
Best Practices
- Review Before Converting - Check markdown quality first
- Choose Right Format - Match format to audience and purpose
- Add Context - Include dates, authors, version numbers
- Test Compatibility - Ensure recipients can open the format
- Archive Sources - Keep original markdown files
- Version Control - Use descriptive filenames with dates
Quick Reference Commands
# 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
Getting Help
For questions about:
- Document conversion → Ask about specific format needs
- Knowledge workflows → See /octo:knowledge-mode
- Document-skills capabilities → See /document-skills:* skills
- Styling and formatting → Ask for best practices by format
Document delivery skill for claude-octopus v7.3.0+
先判断是否适合
作者设计意图
作者的方法与取舍
边界和复核