Agent skill

Sn Proactive Agent

by OpenSenseNova in OpenSenseNova/SenseNova-Skills

安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步. An agent skill from OpenSenseNova/SenseNova-Skills.

MITAuto-check: notes

Install Sn Proactive Agent

skills CLI
$ npx skills add OpenSenseNova/SenseNova-Skills --skill sn-proactive-agent -a claude-code

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

GitHub CLI
$ gh skill install OpenSenseNova/SenseNova-Skills sn-proactive-agent --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-proactive-agent .claude/skills/sn-proactive-agent && 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-proactive-agent
GitHub stars
5.7k
Token cost
~594 tokens
SKILL.md length
154 words
Files
5 (incl. references)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步. An agent skill from OpenSenseNova/SenseNova-Skills.

  • SKILL.md covers 按任务读取说明, 命名与命令, 运行边界 and 查看记录
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sn Proactive Agent is an agent skill from OpenSenseNova/SenseNova-Skills. 安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步。

Its SKILL.md is about 590 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/connectors/hermes.md`, `references/install/macos.md` and `references/install/overview.md`).

It works with macOS. The repository describes itself as: Modular SenseNova skills for building AI-powered office assistants and productivity workflows. The licence is MIT.

Example prompts

  • “/sn-proactive-agent”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 5abde96. 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.

    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 Proactive Agent loads about 594 tokens when it runs, and up to ~7.3k if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~16
When it runs · the whole SKILL.md, loaded when a task matches
~594
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.3k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:47
    - 不读取、打印或复制 API Key、`.env` 或其他凭据。

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 5abde96, republished under its MIT licence (© OpenSenseNova). 154 words, ~594 tokens.

Download SKILL.mdSave it as .claude/skills/sn-proactive-agent/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
sn-proactive-agent
description
安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步。

Proactive Agent

本 Skill 是 Agent 的操作说明,运行代码通过独立的 Python 安装包获取。 服务整理多轮对话中的项目进展,发现值得推进的事情时在 Web 工作台提出建议; 用户接受后,由对应 Connector 交回原 Session 继续执行。

按任务读取说明

  • 询问原理、状态或已有记录时,只做相关的只读检查,不因加载 Skill 就安装、改配置或启动服务。
  • 用户要求安装、启动、升级或卸载时,先读 通用流程,再按实际运行环境读取一份系统说明。
  • 配置对话接入时,只读取当前 Harness 对应的 Connector 说明,不加载其他平台的资料。
条件读取文件
安装、运行与维护服务install/overview.md
macOSinstall/macos.md
Windows PowerShell 或 WSLinstall/windows.md
Hermes 接入connectors/hermes.md

install/ 负责操作系统、依赖和服务生命周期;connectors/ 负责 Harness 配置、对话采集与获批续跑。当前安装入口只支持 Hermes;其他 Harness 不能直接套用 Hermes 的命令。当前运行包为已发布的 0.1.3,可安装指定 Hermes 基线的 Web-only 续跑桥, 会检查源码兼容性、备份并构建;不覆盖未知版本或本地改动。固定版本与 GitHub Release 下载前置检查见通用流程;目前通过 GitHub Release 安装,尚未发布到 PyPI。安装包验收不等于真实接入验收。 Windows 说明是安装参考,不代表完整接入已验收。

命名与命令

  • 本 Skill 的目录和文件名使用英文;除标准入口 SKILL.md 外,使用小写与连字符。
  • 示例命令、参数、变量名和命令块中的注释统一使用英文,中文解释放在命令块外。
  • 保留程序原有的命令名称,不翻译参数。用户真实路径即使含中文,也应按原名正确引用,不为符合示例命名而改动用户文件。

运行边界

  • 安装 Skill 与安装运行包是两件事;pipx 不会把 Skill 安装到 Harness,也不会自动启动服务。
  • 区分运行包、安装文件、目标窗口在线与真实回流检查。doctor --session-id 读取指定窗口的实际证据,不主动发消息;unverified 不等于通过,旧包缺少检查能力也不能视为接入成功。
  • 当前使用 Web 展示建议、接受或忽略、项目进展与日报;服务按 serve --web-only 启动,不启用终端内的重复建议界面。
  • Connector 自动上报完整 QA 和新一轮输入信号;Core 负责归属、状态更新和提醒判断。
  • 建议不是授权。用户接受后,只通过 Connector 续跑原 Session;读取 Skill 的 Agent 不应另外提交同一动作,造成重复执行。
  • 执行结果由 Connector 带 source_suggestion_id 回流;本轮更新状态,不连续生成下一条建议。
  • 不代替后台服务直接编辑 project.md、item.md、events.md 或 runtime.jsonl。
  • 不读取、打印或复制 API Key、.env 或其他凭据。

查看记录

数据默认放在当前用户 Home 下的 .sn-proactive-agent/,不是安装包或源码目录。 可用 --data-root 或 SN_PROACTIVE_AGENT_DATA_ROOT 覆盖。首次有明确长期目标的 完整对话后,服务按归属创建 Project / Item,用户不需要手工建项目;一次性问题可仅记录在运行日志中。

升级用户若已有 .proactive-memory/ 且新目录不存在,自动沿用旧目录,不搬迁或合并。 旧 PROACTIVE_MEMORY_* 环境变量可继续读取,同名的新 SN_PROACTIVE_AGENT_* 设置优先。

以下路径相对于数据根目录:

  • projects/<project-id>/project.md:项目概述和 Item 索引。
  • projects/<project-id>/items/<item-id>/item.md:事项最新状态。
  • projects/<project-id>/items/<item-id>/events.md:相关 QA 与状态变化,用于溯源。
  • runtime.jsonl:对话接收、归属、提醒或静默原因、用户决定、执行结果与日报记录,用于恢复、去重和审计。

Web 读取这些记录的 JSON 展示结果,不直接修改源文件。建议区域保持简短; 详细判断依据保存在运行记录中,按需检查。

© 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

SKILL.md and 4 other files (references) in skills/sn-proactive-agent of OpenSenseNova/SenseNova-Skills.

  • SKILL.md
  • references/connectors/hermes.md
  • references/install/macos.md
  • references/install/overview.md
  • references/install/windows.md

Open the folder on GitHubat commit 5abde96

Compare with similar skills

Sn Proactive Agent 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 Proactive Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sn Proactive Agent this skillOpenSenseNova/SenseNova-Skills5.7k—~594Automated safety check: NotesMIT
Site ArchitectureAvdLee/RocketSimApp80311 repos~3.3kAutomated safety check: PassCustom licence
Engine Whats Newflutter/flutter179k—~978Automated safety check: PassBSD-3-Clause
macOS Spm App PackagingDimillian/Skills4k5 repos~1.2kAutomated safety check: PassMIT
Openclaw Live Updateropenclaw/openclaw392k—~3.7kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca87k1 repos~584Automated safety check: PassApache-2.0

Similar skills

  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    803 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • Engine Whats New

    flutter/flutter

    Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).

    179k GitHub stars~978 tokensUpdated today
    MobileAuto-check passed
  • macOS Spm App Packaging

    Dimillian/Skills

    Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project.

    4k GitHub starsUsed in 5 repos~1.2k tokens
    MobileAuto-check passed
  • Openclaw Live Updater

    openclaw/openclaw

    Maintain the canonical live OpenClaw main checkout, macOS LaunchAgent-managed Gateway, local macOS app, exact-head main CI, and recurring full release validation.

    392k GitHub stars~3.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    87k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed

More from OpenSenseNova/SenseNova-Skills

All 36 skills in this repo
  • 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 starsUsed in 1 repo~2.5k tokens
    Auto-check: notes
  • 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 20 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 starsUsed in 1 repo~954 tokens
    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 20 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 20 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 20 days ago
    Auto-check: notes

Works with

Questions about Sn Proactive Agent

What does Sn Proactive Agent do?

安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步. An agent skill from OpenSenseNova/SenseNova-Skills. Sn Proactive Agent is an agent skill from OpenSenseNova/SenseNova-Skills.

How do I install Sn Proactive Agent in Claude Code?

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

How do I install Sn Proactive Agent in Codex?

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

Can I use Sn Proactive Agent 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-proactive-agent -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-proactive-agent, .gemini/skills/sn-proactive-agent, .github/skills/sn-proactive-agent and .opencode/skills/sn-proactive-agent in your project.

What does Sn Proactive Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Sn Proactive Agent is instructions for the agent only. Our summary lists: Python 3.

Does Sn Proactive Agent 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 Proactive Agent safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Sn Proactive Agent use?

Sn Proactive Agent 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 Proactive Agent use?

About 594 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.7k tokens, read only when the agent opens those files.

What are the alternatives to Sn Proactive Agent?

Skills that share tags, products or a category with Sn Proactive Agent: Site Architecture (AvdLee/RocketSimApp, 803 stars), Engine Whats New (flutter/flutter, 179k stars), macOS Spm App Packaging (Dimillian/Skills, 4k stars) and Openclaw Live Updater (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sn Proactive Agent?

OpenSenseNova (a GitHub organization) maintains it in OpenSenseNova/SenseNova-Skills, which has 5,747 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 18, 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.