TypingMindTypingMindThe best frontend for AI
Sn Proactive Agent logo

Sn Proactive Agent

OrganizationPopular
OpenSenseNova
sn-proactive-agent

安装、启动和使用 Proactive Agent，记录项目进展并在合适时机提醒下一步。

Overview

PublisherOpenSenseNova
RepositorySenseNova-Skills
Skill namesn-proactive-agent
Stars
5.8K
Forks
402
Bundled files
5
LicenseMIT
Links
Skill sourceRepository
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 5 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by OpenSenseNova on GitHub. Read the source before you install it.

Installation

Install the Sn Proactive Agent AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/OpenSenseNova/SenseNova-Skills/tree/main/skills/sn-proactive-agent
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/OpenSenseNova/SenseNova-Skills.git /tmp/SenseNova-Skills
mkdir -p .claude/skills
cp -r /tmp/SenseNova-Skills/skills/sn-proactive-agent .claude/skills/sn-proactive-agent
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Sn Proactive Agent in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Sn Proactive Agent on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Sn Proactive Agent is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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
OpenClaw 接入connectors/openclaw.md

install/ 负责操作系统、依赖和服务生命周期；connectors/ 负责 Harness 配置、对话采集与获批续跑。支持 Hermes 和 OpenClaw，分别按对应说明安装，不能混用命令。 目标运行包版本为 0.1.4，通过 GitHub Release 下载并校验；发布状态检查见通用流程。 Hermes 使用 Web-only 续跑桥，OpenClaw 使用 Gateway 插件。当前 Core 的语义整理与判断仍依赖 已配置模型的 Hermes CLI，即使只监听 OpenClaw，也需准备这个后台工作器。 安装包验收不等于真实接入验收。 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 展示结果，不直接修改源文件。建议区域保持简短； 详细判断依据保存在运行记录中，按需检查。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Sn Proactive Agent AI skill do?

安装、启动和使用 Proactive Agent，记录项目进展并在合适时机提醒下一步。

Why use Sn Proactive Agent on TypingMind?

Because you install it once and use it with any model. Sn Proactive Agent is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Sn Proactive Agent in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/OpenSenseNova/SenseNova-Skills/tree/main/skills/sn-proactive-agent. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Sn Proactive Agent?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Sn Proactive Agent?

As many as you like. As long as a model supports skills, you can use Sn Proactive Agent with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Sn Proactive Agent AI skill free?

Yes. It is published on GitHub by OpenSenseNova under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

Related AI Skills

View all
openclaw logo

Openclaw Debugging

openclaw
OrganizationPopular

Debug OpenClaw model, provider, tool-surface, code-mode, streaming, and live/Crabbox behavior by choosing the right logs, probes, and proof path before changing code, including fetching stored…

82.2K
391K
1 files
View
openclaw logo

Openclaw Live Updater

openclaw
OrganizationPopular

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

82.2K
391K
2 files
View
openclaw logo

Openclaw Pr Maintainer

openclaw
OrganizationPopular

Review, triage, repair, or land OpenClaw issues and pull requests with current-source evidence and the native maintainer workflow.

82.2K
391K
5 files
View
openclaw logo

Openclaw Refactor Docs

openclaw
OrganizationPopular

Refactor an existing OpenClaw docs page with source-audited preservation, restructuring, and verification.

82.2K
391K
Instructions
View

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇