SenseNova-Skills README

The project's README from github.com/OpenSenseNova/SenseNova-Skills. As one markdown file: README.md.

SenseNova-Skills

English | 简体中文

Website Raccoon API Docs SenseNova U1 SenseNova 6.7

The SenseNova model family plugs directly into agent runtimes such as OpenClaw and hermes-agent, with the skills in this repository extending the models with concrete, end-to-end office capabilities.

In this repository each skill lives in its own directory and declares triggers, capabilities, and execution flow through a SKILL.md file, following the Agent Skills convention.

The skills cover image generation & visualization, slide-deck (PPT) generation, Excel data analysis, and deep research — usable standalone or composed into end-to-end workflows.

🎨 Want to see what it can do? Check out our sn-infographic Gallery to explore nearly 100 stunning generation cases and steal their prompt designs !

🦝 Available out-of-the-box in Raccoon

The latest SenseNova models and the full Cowork-Skill suite in this repo are bundled into Raccoon, with enterprise-grade security and a zero-setup experience — if you'd rather not provision env, API keys, and runtimes yourself, you can use these capabilities directly through Raccoon. Free trial available — no payment required to get started.

Raccoon now ships a full upgrade across product capability and client experience:

👉 Try it: xiaohuanxiong.com

How to Use

These skills are designed to run inside an Agent Skills-compatible agent.

This repo documents both the international and mainland China SenseNova API flows. Make sure the docs page, API key, base URL, and model name all come from the same region.

Recommended: let the agent install the skills for you. Hand it the repo URL and ask it to clone and drop the skills into the right directory — for example:

"Please install SenseNova-Skills from https://github.com/OpenSenseNova/SenseNova-Skills into your skills directory."

After it finishes, you may need to manually restart the agent service before the new skills are picked up.

Agent Target directory
OpenClaw ~/.openclaw/skills/
hermes-agent ~/.hermes/skills/
Prefer to install manually?

Clone this repository, then copy the subdirectories under skills/ into the target directory yourself:

git clone https://github.com/OpenSenseNova/SenseNova-Skills.git --depth=1
mkdir -p ~/.openclaw/skills
cp -r SenseNova-Skills/skills/* ~/.openclaw/skills/

For Hermes, swap the target to ~/.hermes/skills/.

Per-category Python dependencies, API keys, and invocation examples are documented in the 📖 Full guide for each section.

Skills List

🎨 Image & Visualization

📖 Full guide: docs/sn-image-generate_en.md (prerequisites, Quick Start, API config, and invocation samples).

Name Label Description
sn-image-doctor Environment Doctor Validates the SenseNova-Skills environment — checks sn-image-base install, Python deps, and required env vars; interactively fills missing values into .env.
sn-image-base Image Base Layer (Tier 0) Low-level tools — text-to-image (sn-image-generate), image editing (sn-image-edit), image recognition (sn-image-recognize), and text optimization (sn-text-optimize) — exposed through a unified sn_agent_runner.py, designed to be called by upper-layer skills.
sn-infographic Infographic Generation (Tier 1) Auto prompt-quality scoring, layout/style selection (87 layouts / 66 styles), multi-round generation with VLM review and quality ranking, producing publication-ready infographics.
sn-image-imitate Image Imitation (Tier 1) Given one reference image and a target content prompt, generates a new image that imitates the reference.
sn-image-resume Resume Image Generation (Tier 1) Given resume information, generates a resume image.

📊 Presentations (PPT)

📖 Full guide: docs/sn-ppt-generate.md (prerequisites, Quick Start, API config, and invocation samples).

Name Label Description
sn-ppt-entry PPT Entry Point Unified entry point for PPT generation. Asks the user to choose fast, standard, or creative mode, then collects role / audience / scenario / page count. For standard mode, also asks about image sourcing (AI, web search, or none) and chart rendering (U1 infographics or ECharts). Parses uploaded pdf / docx / md / txt, emits task_pack.json + info_pack.json, and dispatches to the chosen mode.
sn-ppt-doctor PPT Environment Doctor Environment check for the PPT pipeline — validates sn-image-base, API keys, the Node runtime, and optional deps; writes missing required vars into .env.
sn-ppt-creative PPT Creative Mode One full-page 16:9 PNG per slide, generated via sn-image-generate with a per-page composed prompt. Falls back to web image search when T2I generation fails.
sn-ppt-standard PPT Standard & Fast style_spec → outline → asset plan + per-slot images + VLM QC → per-page HTML → per-page review → PPTX export. Fast mode builds a complete draft immediately with autonomous decisions, then provides structured refinement suggestions. Supports AI-generated infographics (U1) for diagrams and web image search (Serper) for real photos.

📈 Data Analysis (DA)

📖 Full guide: docs/sn-data-analysis.md (prerequisites, Quick Start, API config, and invocation samples).

Name Label Description
sn-da-excel-workflow Excel Analysis Orchestration End-to-end Excel pipeline — multi-sheet read, large-file detection (≥10k rows triggers Parquet), cleaning, conditional filtering, cross-sheet aggregation, and Excel/CSV export.
sn-da-image-caption Image Understanding & Data Extraction For image-first inputs — table OCR, chart understanding, screenshot/UI description; parses captions into DataFrames, recreates visualizations, exports Excel/CSV.
sn-da-large-file-analysis High-Performance Large-File Analysis Streaming reads for ≥10k-row Excel datasets (openpyxl read_only + iter_rows), Parquet conversion, memory optimization, chunked processing, large-file writes.

🔬 Deep Research

📖 Full guide: docs/sn-deep-research.md (prerequisites, web_search precheck, Quick Start, and per-stage invocation).

Name Label Description
sn-deep-research Deep Research Entry Point Mode-aware deep-research orchestrator with parallel research work packages, one-pass quick/normal synthesis, and an auditable heavy workflow, producing final report.md.
sn-research-report Final Report Writing & Editing Renders the judgment layer into the final report.md; also handles targeted rewrites — restructuring, polishing, table-augmentation — for an existing draft.
sn-report-format-discovery Presentation-Format Discovery Optional standalone format recommendation; sn-deep-research uses a single request-level format string instead of format artifacts.
sn-prepare-citations Citation Rendering Post-processes [^source_id] footnotes into numbered citations and appends references from evidence sources.
sn-md-to-html-report Markdown → HTML Report Converts the research report.md (or any Markdown doc) into a clean, single-file HTML reading view that opens offline — embedded images, side-panel TOC, responsive tables, and table-delimiter repair.

📖 Search skills are documented together with deep research: docs/sn-deep-research.md (includes per-platform API keys, invocation, and unified JSON output).

Name Label Description
sn-search-academic Academic Search ArXiv (with section-level HTML reading) / Semantic Scholar (with citation counts) / PubMed (with PMC open-access full text) / Wikipedia, in one aggregated interface.
sn-search-code Developer Search GitHub (repo / code / issue) / Stack Overflow / Hacker News / HuggingFace (models / datasets / spaces), aggregated.
sn-search-social-cn Chinese Social Search Bilibili / Zhihu / Douyin search; some platforms require cookie auth.
sn-search-social-en English Social Search Reddit / Twitter (X) / YouTube search.

Sample Outputs

🎨 Infographic (sn-infographic)

A few sn-infographic outputs (more in docs/sn-infographic-examples.md).

sn-infographic sample outputs

🧩 Memory price analysis — insight → analysis → presentation → end-to-end workflow

examples/memory-price-end2end-analysis. Starting from a raw quote CSV, the agent profiles fields, normalizes categories and timestamps, then attacks the rally from three angles — overall trend, top movers per category, and the gap between server-grade and consumer-grade SKUs — locating a late-February inflection along the way. Treating those findings as the research question, it switches to deep research: planning per-dimension web searches over supply contraction, AI-server demand, and vendor output discipline, then triaging and cross-checking evidence across sources before committing it to the report. The data and research conclusions are then handed to PPT generation, which lays out a 16-page outline, plans per-slot imagery, renders per-page HTML, runs VLM review, and finally composites screenshots into the PPTX. The result is a clear three-step storyline: prices are rising → here is why → here is what to do. This is the only example that exercises the full data analysis → deep research → PPT chain end-to-end.

📊 Employee performance analysis — data analysis

examples/employee-performance-analysis. The agent reads 10 separate monthly review xlsx files, aligns column schemas across months and joins them into one longitudinal table. From that table it produces aggregate views — monthly average trend, score-distribution boxplots, grade mix change, and a 38-role ranking — and individual views — top performers, needs-attention, and consistently-improving cohorts plus per-employee year trends. The findings are written up with explicit improvement suggestions tied to specific roles and individuals, backed by 8 supporting charts. The same content is delivered as a Word doc (for distribution) and a visualized HTML report (for browsing). The example shows how sn-da-excel-workflow handles "many small spreadsheets that should be one analysis" rather than a single big file.

🔬 Embodied AI industry research — deep research

examples/embodied-ai-deep-research. Given only an industry name, the agent first commits to a research plan — market size, vendor share, financing, cost structure, development roadmap — instead of jumping straight into search. For each dimension it runs targeted web searches, fetches and reads source pages, and extracts both numeric and qualitative evidence; conflicting figures across sources are explicitly reconciled before being trusted. A synthesis stage organizes per-dimension evidence into a traceable, reader-oriented information structure rather than a stack of disconnected bullets. The output is an illustrated report (Markdown + visualized HTML) with 5 dimension-specific charts. The example shows how sn-deep-research turns "go research X" into a structured plan-then-execute loop with traceable evidence.

🎯 Property fee pricing — PPT generation

examples/property-fee-pricing-ppt. The agent takes a free-form brief — topic (property fee pricing), audience (property staff + committee), 26 pages, black-and-white warm style — and first commits to an outline plus a per-page asset plan that conforms to the style spec. Each slide is then built as semantic per-page HTML rather than free-form image generation: copy, layout, illustrations, icons, and any data charts are reasoned about per slot. Imagery is produced or selected per slot and VLM-checked against the page's intent; each rendered page goes through a review pass with optional rewrite for coherence and copy quality. Final pages are screenshotted and composited into the PPTX, with the per-page HTML kept alongside for direct browser preview or re-editing. The example demonstrates sn-ppt-standard style consistency on a long, prose-heavy deck where every slide must obey the same audience and palette constraints.

FAQ

Common setup and runtime questions (400/401 errors, rate limits, PPT timeouts, infographic quality, model names) are answered in docs/faq.md.

Contribut

SenseNova-Skills (OpenSenseNova/SenseNova-Skills)

Searching Database…

这是什么?一个面向 SenseNova 模型系列的模块化 Agent Skills 库,为办公助手类智能体提供具体的端到端能力:图像生成与信息图、PPT/幻灯片生成、Excel 数据分析和深度研究。既可以单独使用,也可以串联成工作流。
这是独立应用,还是我要接入智能体的组件?它不是独立应用。每个技能都位于自己的目录中,包含一个 SKILL.md 文件,用来声明其触发条件、能力和执行流程,遵循 Agent Skills 约定,需要在兼容的智能体运行时中运行。
这些技能要怎么安装?克隆仓库,然后把 skills/ 下的子目录复制到你的智能体 skills 目录中——OpenClaw 用 ~/.openclaw/skills/,hermes-agent 用 ~/.hermes/skills/——然后重启智能体服务。你也可以直接把仓库地址发给你的智能体,让它帮你安装这些技能。
需要什么智能体运行时和 API 密钥?你需要一个兼容 Agent Skills 的运行时,具体是 OpenClaw 或 hermes-agent,还需要一个 SenseNova 平台 API 密钥,可以来自国际站(platform.sensenova.ai)或中国大陆站(platform.sensenova.cn)。
配置 API 时会有什么坑吗?有的。仓库同时涵盖国际站和中国大陆站的 SenseNova API 流程,如果把一个地区的密钥或基础 URL 与另一个地区的文档混用,就会出问题;每个技能类别还有各自的 Python 依赖,需要分别安装。
这个项目适合谁?适合在 OpenClaw、hermes-agent 等智能体运行时上开发 AI 办公助手的开发者,他们希望直接使用现成的图像、演示文稿、表格和研究能力,而不必从头自己做。
不想自己配置 API 密钥,有没有办法先试用?有。Raccoon 内置了最新的 SenseNova 模型和完整的 Cowork-Skill 套件,开箱即用,提供免费试用,开始使用无需付费。
PPT 生成技能到底能产出什么?它提供快速、标准和创意三种模式,可以通过 AI 生成或网络搜索获取幻灯片图片,用信息图或 ECharts 制作图表,并导出完成的 PPTX 文件。
Excel 数据分析技能能处理什么?它可以读取多工作表的工作簿,超过 1 万行时自动切换到流式/Parquet 处理,清洗和筛选数据,跨工作表汇总,并把结果导出为 Excel 或 CSV 文件。
深度研究技能可以从哪些来源获取信息?学术来源(ArXiv、Semantic Scholar、PubMed、Wikipedia)、开发者来源(GitHub、Stack Overflow、Hacker News、HuggingFace)和社交平台(Bilibili、知乎、抖音、Reddit、Twitter/X、YouTube),最终汇总成一份报告。
Size
146.2 MB
Stars
5.8K
Updated
CommitOct 09
Age
6mo
Commits · 90 Days