Agent skill

Sn Ppt Story

by OpenSenseNova in OpenSenseNova/SenseNova-Skills

当前 PPT 任务已由 sn-ppt-entry 建好 DECKDIR(taskpack.json 与 infopack.json 已写入)后,必须由本 skill 将 query、全部用户材料与已完成 Research 编排为唯一可编辑的 outline.md 时使用。本 skill 是 entry → 出口(standard / dazzle /…

MITAuto-check passedDocuments & Office

Install Sn Ppt Story

skills CLI
$ npx skills add OpenSenseNova/SenseNova-Skills --skill sn-ppt-story -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenSenseNova/SenseNova-Skills sn-ppt-story --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenSenseNova/SenseNova-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sn-ppt-story .claude/skills/sn-ppt-story && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sn-ppt-story
GitHub stars
5.7k
Token cost
~986 tokens
SKILL.md length
221 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

当前 PPT 任务已由 sn-ppt-entry 建好 DECKDIR(taskpack.json 与 infopack.json 已写入)后,必须由本 skill 将 query、全部用户材料与已完成 Research 编排为唯一可编辑的 outline.md 时使用。本 skill 是 entry → 出口(standard / dazzle /…

  • Works in 4 steps: 完整理解 → 先确定整套 Story → 再规划逐页逻辑 → …
  • Documents & Office work in your project
  • SKILL.md covers 输入边界, 输出和状态, 工作方法 and outline.md 格式, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sn Ppt Story is an agent skill from OpenSenseNova/SenseNova-Skills. 当前 PPT 任务已由 sn-ppt-entry 建好 DECKDIR(taskpack.json 与 infopack.json 已写入)后,必须由本 skill 将 query、全部用户材料与已完成 Research 编排为唯一可编辑的 outline.md 时使用。本 skill 是 entry → 出口(standard / dazzle / creative)之间的强制中间环节:不允许执行 Agent 跳过本 skill 直接依据 taskpack / infopack 即兴编写大纲,不允许出口 skill 代写或改写大纲;前置产物缺失时停止并返回 sn-ppt-entry 补齐,不得自行补做研究。

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office. The repository describes itself as: Modular SenseNova skills for building AI-powered office assistants and productivity workflows. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/sn-ppt-story”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. 完整理解
  2. 先确定整套 Story
  3. 再规划逐页逻辑
  4. 做三轮 Story 自审

What it can do on your machine

Read from SKILL.md and the folder at commit 7838651. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sn Ppt Story loads about 986 tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 221 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~986

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenSenseNova/SenseNova-Skills at commit 7838651, republished under its MIT licence (© OpenSenseNova). 221 words, ~986 tokens.

Download SKILL.mdSave it as .claude/skills/sn-ppt-story/SKILL.md (or your agent's skills folder).
name
sn-ppt-story
description
当前 PPT 任务已由 sn-ppt-entry 建好 DECK_DIR(task_pack.json 与 info_pack.json 已写入)后,必须由本 skill 将 query、全部用户材料与已完成 Research 编排为唯一可编辑的 outline.md 时使用。本 skill 是 entry → 出口(standard / dazzle / creative)之间的强制中间环节:不允许执行 Agent 跳过本 skill 直接依据 task_pack / info_pack 即兴编写大纲,不允许出口 skill 代写或改写大纲;前置产物缺失时停止并返回 sn-ppt-entry 补齐,不得自行补做研究。
metadata.project
SenseNova-Skills
metadata.tier
1
metadata.category
scene
metadata.user_visible
false
triggers
sn-ppt-story, 生成大纲, 修改大纲, storyline, outline.md

sn-ppt-story

把 query、全部用户材料和已经完成的研究综合成一份清楚、完整、可直接修改的 outline.md。Story 统一管理内容理解和页面叙事,不生成页面,不自行开展外部研究。

输入边界

只接受 Entry 传入的绝对 DECK_DIR。开始前读取:

  • <DECK_DIR>/task_pack.json
  • <DECK_DIR>/info_pack.json
  • info_pack.raw_documents 指向的完整 raw_documents.json(存在时)
  • info_pack.research_report 指向的 Research 主报告(存在时)
  • 用户明确要求读取的其他源文件
  • 当前 <DECK_DIR>/outline.md(修改或继续任务时)

用户材料是事实来源,query 是任务目标,Research 是外部证据补充。三者冲突时明确区分 “用户要求”“材料事实”“外部证据”和“推断”,不得用顺畅文案掩盖冲突。

task_pack.state.research.required == true 时,Story 开始前必须已有 info_pack.research_report 指向的可读报告。缺失时停止并返回 Entry 完成 task_pack.state.research.executor 指定的证据路径;不得先写 outline 再补研究。Standard 默认读取 Entry 写入的定向搜索摘要,Deep 默认读取 sn-deep-research 的完整报告,Story 不把 Standard 自动升级为 Deep。

输出和状态

  • 唯一用户叙事文件:<DECK_DIR>/outline.md
  • 不创建 outline_v2.md、story spec、页面 JSON 或另一份并行大纲。
  • 开始时把 task_pack.state.current_stage 更新为 story,状态更新为 storytelling。
  • 完成时把 story 加入 completed_stages,把 outline 绝对路径写入 state.artifacts.outline,把 task_pack.params.page_count 同步为当前连续页数,状态更新为 story_ready。
  • 修改现有大纲时覆盖同一文件,并清晰标记哪些下游页面需要重新生产;不要清除 Research 和材料解析的完成状态。

工作方法

1. 完整理解

阅读与任务相关的全部内容,而不是只看标题、摘要或开头。材料较长时可以分段读取, 但最终综合必须覆盖:

  • 可以直接使用的事实、数据、案例、定义和结论;
  • Markdown/DOCX 表格及文档内图片所承载的信息;
  • 多份材料的重复、冲突、时效和口径差异;
  • 受众真正需要做出的理解、判断或行动;
  • 仍然缺少证据、只能作为推断或需要弱化表达的内容。

document_digest 是索引和辅助,不替代原文。决定性数字、专有名词、时间、单位和引用 必须回到原材料或 Research 主报告核对。

2. 先确定整套 Story

在排页前明确:

  1. 谁在什么场景下向谁表达;
  2. 演示希望受众理解、相信或决定什么;
  3. 全套唯一的核心观点;
  4. 采用什么论证路径,为什么按这个顺序;
  5. 最后一页应留下什么结论或行动方向。

不要把材料目录机械改成页面目录。内容应形成连续推进,例如“建立背景 -> 暴露关键矛盾 -> 给出判断框架 -> 用证据验证 -> 落到方案或行动”,具体结构由任务决定。

3. 再规划逐页逻辑

每页只承担一个主要任务,并明确:

  • 页面标题;
  • 受众看完必须记住的完整结论;
  • 支撑结论的事实、数据、案例和自然语言来源;
  • 它如何承接上一页并推动下一页;
  • 信息之间的关系和建议的表达方式。

页面表达只描述用户能理解的意图,例如“用统一维度对比三种方案”或“用趋势图说明拐点”。 不要写像素、坐标、HTML 节点、组件 ID、内部页型代码或出口实现细节。

4. 做三轮 Story 自审

这不是模型评测,也不产生测试文件。写入前在当前上下文中连续复读三次:

  1. 证据审查:决定性结论是否有材料或 Research 支持,事实/推断/待确认是否清楚。
  2. 逻辑审查:是否存在结论先于依据、页面重复、因果跳跃、前后矛盾或最后没有落点。
  3. 演示审查:每页是否只有一个主要任务,页数是否合理,标题和结论是否让用户一眼 看懂,整体思路是否能独立概括全套。

发现问题直接改 outline.md 草稿,不生成审查报告。

outline.md 格式

只用普通 Markdown 和少量标题层级:

markdown
# 演示标题

## 整体思路

说明受众、场景、目标、核心观点、叙事路径及最终落点。

## 第 1 页:页面标题

### 这一页要说明什么

一句完整、明确、可验证的结论。

### 内容与依据

- 需要呈现的事实、数据、论点或案例。
- 来源用自然语言说明,例如“来自 planning_plan.md 的 Presentation Skill 部分”。
- 只能推断或仍缺证据时明确写“推断”或“待补充”。

### 前后关系

说明本页如何承接上一页并推动下一页;封面可说明它如何设定问题。

### 页面表达

说明信息关系、视觉重点和建议表达方式。

## 第 2 页:页面标题
...

硬约束:

  • ## 第 N 页 的顺序就是最终页序,编号连续。
  • 开头必须有“整体思路”,单独阅读它就能明白全局逻辑。
  • 每页必须有“这一页要说明什么”,不能只写宽泛主题。
  • 用户指定页数时遵守;材料明显无法支撑时先说明,不用空页凑数。
  • 不自动添加用户未要求且叙事不需要的目录、过渡、行动或结束页。
  • 不把设计丰富度误写成 Story 复杂度;Story 对所有出口相同。

新建与修改

新建
  1. 读取全部输入和 Research。
  2. 确定整体 Story。
  3. 完成逐页编排。
  4. 做三轮自审。
  5. 写入唯一 outline.md 并更新 task_pack.json。
  6. 返回路径、页数和一行叙事摘要。
修改

磁盘上的 outline.md 是唯一基线:

  • 先完整读取,再修改;
  • 局部要求只改相关页面及保持逻辑连续所必需的相邻内容;
  • 用户调换页序后保留该顺序,只修正承接关系;
  • 用户删除页面或观点后,不用同义措辞补回;
  • 用户明确写下的标题、结论和原文尽量原样保留;
  • 新事实需要 Research 时返回 Entry,Research 完成后再改;
  • 新证据与用户修改冲突时保留磁盘版本,报告冲突并等待决定,不擅自覆盖。

与出口的契约

所有出口必须在开始和恢复时重新读取当前 outline.md。它决定:

  • 整体目标、受众、核心观点和叙事路径;
  • 最终页数、页序和页面标题;
  • 每页角色、核心结论、必须出现的事实与内容关系。

出口可以补逐字文案、视觉系统、素材、版式、动画和实现细节,但不能重新研究、另写内容 大纲、恢复用户删除的内容或改变核心结论。出口发现事实不足时应停止相关页面,返回 Entry/Story 说明缺口。

不得做

  • 不调用外部模型客户端或第二套 API。
  • 不直接搜索网页;外部证据由 Entry 在 Story 之前完成:Standard 使用定向普通搜索, Deep 使用 sn-deep-research。
  • 不生成 HTML、图片、渲染图或 PPTX。
  • 不创建细碎跨 Skill spec。
  • 不把未经支持的数字写成事实。
  • 不把 Story 变成某个出口的视觉模板选择器。

© OpenSenseNova, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/sn-ppt-story of OpenSenseNova/SenseNova-Skills.

Open the folder on GitHubat commit 7838651

Compare with similar skills

Sn Ppt Story next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sn Ppt Story compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sn Ppt Story this skillOpenSenseNova/SenseNova-Skills5.7k—~986Automated safety check: PassMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from OpenSenseNova/SenseNova-Skills

All 36 skills in this repo
  • SN Motion HTML

    OpenSenseNova/SenseNova-Skills

    Builds HTML stories where one continuous camera journey advances with page progress, using researched structure, AI stills, Seedance video clips and browser QA.

    5.7k GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Fallback Tools

    OpenSenseNova/SenseNova-Skills

    Fallback scripts for web search, image search and download, and image generation that PPT skills use only when the host agent lacks or fails its own tools.

    5.7k GitHub stars~575 tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Workbench

    OpenSenseNova/SenseNova-Skills

    Opens the PPT Workbench web editor for an existing SenseNova HTML slide deck so you can preview, inspect and visually edit it without regenerating.

    5.7k GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Creative Renderer

    OpenSenseNova/SenseNova-Skills

    Turns an approved slide outline into a full-page image for every slide, one 16:9 PNG per page, and optionally packages the set into a PPTX.

    5.7k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • SenseNova PPT Entry

    OpenSenseNova/SenseNova-Skills

    Entry point for SenseNova presentation generation: creates a task folder, picks depth, output format and design richness, and routes to the right PPT skill.

    5.7k GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check: notes
  • China Market Open Data Search

    OpenSenseNova/SenseNova-Skills

    Researches Chinese market, macro, trade, procurement, listed-company and regulatory information from free official sources that need no sign-up or API key.

    5.7k GitHub stars~954 tokensUpdated 2 days ago
    Auto-check: notes

Questions about Sn Ppt Story

What does Sn Ppt Story do?

当前 PPT 任务已由 sn-ppt-entry 建好 DECKDIR(taskpack.json 与 infopack.json 已写入)后,必须由本 skill 将 query、全部用户材料与已完成 Research 编排为唯一可编辑的 outline.md 时使用。本 skill 是 entry → 出口(standard / dazzle /…. Sn Ppt Story is an agent skill from OpenSenseNova/SenseNova-Skills.

When should I use Sn Ppt Story?

Sn Ppt Story fits situations like: documents & Office work in your project.

How do I install Sn Ppt Story in Claude Code?

Run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-ppt-story -a claude-code`. Or copy the skill folder (skills/sn-ppt-story in OpenSenseNova/SenseNova-Skills) into .claude/skills/sn-ppt-story in your project. Claude Code loads it when a task matches its description.

How do I install Sn Ppt Story in Codex?

Run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-ppt-story -a codex`. Or copy the skill folder (skills/sn-ppt-story in OpenSenseNova/SenseNova-Skills) into .agents/skills/sn-ppt-story in your project. Codex loads it when a task matches its description.

Can I use Sn Ppt Story in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-ppt-story -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sn-ppt-story, .gemini/skills/sn-ppt-story, .github/skills/sn-ppt-story and .opencode/skills/sn-ppt-story in your project.

What does Sn Ppt Story need to run?

SKILL.md names no scripts, command-line tools or credentials: Sn Ppt Story is instructions for the agent only.

Does Sn Ppt Story access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sn Ppt Story safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sn Ppt Story use?

Sn Ppt Story is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sn Ppt Story use?

About 986 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sn Ppt Story?

Skills that share tags, products or a category with Sn Ppt Story: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sn Ppt Story?

OpenSenseNova (a GitHub organization) maintains it in OpenSenseNova/SenseNova-Skills, which has 5,749 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 9, 2026.

Source: OpenSenseNova/SenseNova-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.