Skip to content
FunCoding

Search

Search docs, Skills and MCP

sn-ppt-tools

Use when another PPT Skill needs web search, image search or download, or image generation and the host Agent's equivalent native capability is absent or has failed.

文档与办公5.7kskills/sn-ppt-tools/SKILL.md

Install

Send this to Claude Code, Codex or Cursor. The agent checks the Skill for safety first and installs it only after you confirm.

读取 https://funcoding.ai/skills/opensensenova/sensenova-skills/sn-ppt-tools/install.md ,按里面的步骤帮我安装这个 Skill。

SKILL.md

sn-ppt-tools

这是 PPT Skill 整包自带的备用工具,不是独立内容生产流程。调用前先读 references/capability-policy.md。宿主 Agent 的等价原生工具始终优先;只有原生能力 不存在或一次实际调用确认不可用时,才调用这里的脚本。

持久配置

四个脚本每次启动都会自动加载一个用户级 .env:

  1. 设置了 SN_PPT_ENV_FILE 时读取该文件;
  2. OpenClaw 读取 ~/.openclaw/.env;
  3. 其他环境默认读取 ~/.hermes/.env。

已有进程环境变量优先,.env 只补充缺失项。不要把 secret 写进 Skill 目录、workspace、 命令行、prompt 或 task pack。完整模板和缺失项检查通过 sn-ppt-doctor 查看。

普通搜索

python3 "$PPT_TOOLS_DIR/scripts/web_search.py" "QUERY" --num 10

配置:

  • URL:SN_PPT_WEB_SEARCH_URL;否则 SN_PPT_SEARCH_BASE_URL / SERPER_BASE_URL 加 /search。
  • Key:SN_PPT_WEB_SEARCH_API_KEY -> SN_PPT_SEARCH_API_KEY -> SERPER_API_KEY。

图片搜索与下载

python3 "$PPT_TOOLS_DIR/scripts/image_search.py" "QUERY" --num 10

python3 "$PPT_TOOLS_DIR/scripts/fetch_image.py" \
  "https://example.com/image.png" \
  --deck-dir "$DECK_DIR" \
  --output "assets/image.png" \
  --referer "https://example.com/source-page"

图片搜索配置:

  • URL:SN_PPT_IMAGE_SEARCH_URL;否则 SN_PPT_SEARCH_BASE_URL / SERPER_BASE_URL 加 /images。
  • Key:SN_PPT_IMAGE_SEARCH_API_KEY -> SN_PPT_SEARCH_API_KEY -> SERPER_API_KEY。

先根据搜索元数据选择候选,再下载选中的图片。不得把远程 URL 直接留在最终 deck。

图片生成

python3 "$PPT_TOOLS_DIR/scripts/image_generate.py" \
  --prompt-file "$DECK_DIR/pages/page_001.prompt.txt" \
  --deck-dir "$DECK_DIR" \
  --output "pages/page_001.png" \
  --size "2752x1536"

配置:

  • URL:SN_PPT_IMAGE_GEN_URL;否则 SN_IMAGE_GEN_BASE_URL / SN_BASE_URL 加 /images/generations。
  • Key:SN_PPT_IMAGE_GEN_API_KEY -> SN_IMAGE_GEN_API_KEY -> SN_API_KEY。
  • Model:SN_PPT_IMAGE_GEN_MODEL -> SN_IMAGE_GEN_MODEL。

只支持 OpenAI/SenseNova 兼容的同步 POST /images/generations 协议,响应可以是 data[].url 或 data[].b64_json。不在这里扩展其他 provider。

输出与失败

  • 成功输出单行 JSON,status 为 ok。
  • 缺少配置输出 status=unavailable,退出码为 2。
  • 请求或落盘失败输出 status=failed,退出码为 1。
  • 所有图片只能写入调用方给定的绝对 DECK_DIR 内。
  • Key 不通过命令行传递,不写入输出、日志、task pack 或 deck 文件。
  • 同一能力调用失败后不循环重试;由调用 Skill 按 policy 继续无工具路径。

Similar Skills

pdf
anthropics/skills180k

pdf

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

Docs & office

discernment-nudge
anthropics/skills180k

discernment-nudge

After you give a substantive answer or draft that the user may act on — advice or recommendations, drafted artifacts such as goals, plans, pitches, proposals, or emails, estimates or projections, analysis or interpretation of data, factual claims they may rely on, or a multi-step argument — invoke this skill BEFORE finalizing your reply and then, if it applies, append 2-3 short follow-up questions, each tied to something specific in what you just produced, that help the user check key facts, probe the reasoning or assumptions, and notice missing context. Do this at most once per conversation. Skip it when the user asked a trivial how-to or simple lookup, wants a purely educational explanation, asked you only to format, convert, or assemble a file from content they provided, is writing code they will run, is doing creative writing or casual chat, or already asked you to double-check, cite, or review — the skill file explains these boundaries and the exact output format.

Docs & office

doc-coauthoring
anthropics/skills180k

doc-coauthoring

Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.

Docs & office

docx
anthropics/skills180k

docx

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

Docs & office

pptx
anthropics/skills180k

pptx

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

Docs & office

canvas-design
anthropics/skills180k

canvas-design

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

Docs & office