功能描述

Archive, browse, and manage chat content including links, notes, and images with read/star status and pagination in an IM-native inbox.

使用说明 (SKILL.md)

Little Steve Content Inbox

Name: Little Steve Content Inbox
Author: echoofzion

A lightweight content archiving and review tool for IM workflows. Archive links, notes, and images sent in chat, manage their read status, and browse with pagination.

Data Files

skills/little-steve-content-inbox/data/items.json
skills/little-steve-content-inbox/data/view-state.json

Agent Command Conventions

Add link

bash {baseDir}/scripts/inbox.sh add --type link --title "Article title" --url "https://example.com/article" --tags "tech,ai"

Add note

bash {baseDir}/scripts/inbox.sh add --type note --title "Quick thought" --content "Some text content to save"

Add image

bash {baseDir}/scripts/inbox.sh add --type image --title "Screenshot" --media-path "/path/to/image.png"

List items (default: all, 10 per page)

bash {baseDir}/scripts/inbox.sh list --status all
bash {baseDir}/scripts/inbox.sh list --status unread
bash {baseDir}/scripts/inbox.sh list --status read
bash {baseDir}/scripts/inbox.sh list --status starred

Next page

bash {baseDir}/scripts/inbox.sh more

View item detail

bash {baseDir}/scripts/inbox.sh view --id \x3Cid>

Update status

bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status read
bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status starred
bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status unread

Delete item

bash {baseDir}/scripts/inbox.sh delete --id \x3Cid>

Content Types

link — web URL (article, tweet, page)
note — plain text
image — local image file
video — (reserved for future use)

Status Enum

unread — new, not yet reviewed
read — reviewed
starred — bookmarked / favorited

IM Output Format

List: newest first, 10 items per page
Per item: [status][type] #ID title (compact, no URL/path in list)
Footer: -- more: N total, showing X-Y -- or -- end: N total --
Full URL/path only shown in detail view (view --id)

Important: Explicit Intent Only

Do NOT auto-archive. Only run add when the user explicitly asks to save/archive content using keywords such as: 收录, 归档, 保存, 记录, archive, save, bookmark. If the user simply shares a URL, text, or image in conversation without these keywords, treat it as normal chat — do not archive it.

IM Natural Language Mapping

User says	Command
收录/Archive/Save `\x3Curl>`	`add --type link --url \x3Curl> --title \x3Cextracted>`
记录/Save/Note `\x3Ctext>`	`add --type note --title \x3Csummary> --content \x3Ctext>`
归档图片 / Archive image	`add --type image --title \x3Cdesc> --media-path \x3Cpath>`
Inbox / Content list	`list --status all`
Unread list	`list --status unread`
Read list	`list --status read`
Starred / Favorites	`list --status starred`
More	`more`
View #ID	`view --id \x3Cid>`
Mark read #ID	`status --id \x3Cid> --status read`
Mark unread #ID	`status --id \x3Cid> --status unread`
Star #ID	`status --id \x3Cid> --status starred`
Unstar #ID	`status --id \x3Cid> --status unread`
Delete #ID	`delete --id \x3Cid>`

小史内容收件箱

面向聊天工作流的轻量内容归档与回看工具。将聊天中发送的链接、文字、图片统一归档，按状态管理，分页浏览，随时可查。

数据文件

skills/little-steve-content-inbox/data/items.json
skills/little-steve-content-inbox/data/view-state.json

Agent 执行约定

收录链接

bash {baseDir}/scripts/inbox.sh add --type link --title "文章标题" --url "https://example.com/article" --tags "tech,ai"

记录文字

bash {baseDir}/scripts/inbox.sh add --type note --title "随手记" --content "要保存的文字内容"

归档图片

bash {baseDir}/scripts/inbox.sh add --type image --title "截图" --media-path "/path/to/image.png"

查看列表（默认全部，每页10条）

bash {baseDir}/scripts/inbox.sh list --status all
bash {baseDir}/scripts/inbox.sh list --status unread
bash {baseDir}/scripts/inbox.sh list --status read
bash {baseDir}/scripts/inbox.sh list --status starred

bash {baseDir}/scripts/inbox.sh more

查看详情

bash {baseDir}/scripts/inbox.sh view --id \x3Cid>

更新状态

bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status read
bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status starred
bash {baseDir}/scripts/inbox.sh status --id \x3Cid> --status unread

删除

bash {baseDir}/scripts/inbox.sh delete --id \x3Cid>

内容类型

link — 网页链接（文章、推文、页面）
note — 纯文字
image — 本地图片文件
video — （预留）

状态枚举

unread — 未读
read — 已读
starred — 收藏

IM 输出规范

列表：最新优先，每页10条
每条显示：[状态][类型] #ID 标题（精简，列表不显示 URL/路径）
页脚：-- more: 共N条, 显示X-Y -- 或 -- end: 共N条 --
完整 URL/路径仅在详情视图中显示（view --id）

重要：仅在明确指令时收录

不要自动收录。 只有当用户明确使用"收录、归档、保存、记录、archive、save、bookmark"等关键词时才执行 add。如果用户只是在聊天中分享链接、文字或图片，但没有使用这些关键词，按正常对话处理，不要归档。

IM 自然语言映射

用户说	对应命令
收录 / 归档 `\x3Curl>`	`add --type link --url \x3Curl> --title \x3C提取>`
记录 / 保存 `\x3C文字>`	`add --type note --title \x3C摘要> --content \x3C文字>`
归档图片	`add --type image --title \x3C描述> --media-path \x3C路径>`
内容列表 / 收件箱	`list --status all`
未读列表	`list --status unread`
已读列表	`list --status read`
收藏列表	`list --status starred`
更多	`more`
查看 #ID	`view --id \x3Cid>`
已读 #ID	`status --id \x3Cid> --status read`
未读 #ID	`status --id \x3Cid> --status unread`
收藏 #ID	`status --id \x3Cid> --status starred`
取消收藏 #ID	`status --id \x3Cid> --status unread`
删除 #ID	`delete --id \x3Cid>`

安全使用建议

This skill is a local, script-based inbox that stores items in skills/little-steve-content-inbox/data/*. It does not request credentials or make network calls. Before installing: 1) Ensure jq is available (brew install jq or your package manager) because the scripts require it but registry metadata omitted it. 2) Be aware that when you add an image you provide a media-path; the script records that file path but does not copy or upload it — so it can expose local path strings in the stored JSON and when viewed. 3) Review the included scripts if you have privacy concerns (they read/write the JSON files and create a media dir, but do not exfiltrate data). 4) The skill correctly implements an explicit keyword-only rule for adding items (it will not auto-archive), which you should keep in mind when using it in chat. If you want tighter guarantees, run the scripts in a sandboxed environment or inspect/modify them to suit your security posture.

功能分析

Type: OpenClaw Skill Name: little-steve-content-inbox Version: 0.1.5 The skill bundle is a legitimate content archiving and management tool for links, notes, and images. The implementation in `scripts/inbox.sh` and `scripts/content-im.sh` uses `jq` with proper argument passing (`--arg`) to prevent injection vulnerabilities and includes explicit validation functions for IDs, URLs, and tags. The `SKILL.md` instructions even include a safety constraint directing the agent not to auto-archive content without explicit user intent, and file permissions are restricted using `chmod 600` during initialization.

能力评估

ℹ Purpose & Capability

The skill's name/description align with the included scripts and data files: it stores, lists, views, updates status, and deletes items. Minor inconsistency: SKILL.md declares a required binary (jq) but the registry metadata lists no required binaries; jq is actually required at runtime (scripts call jq).

✓ Instruction Scope

SKILL.md instructs the agent to run local scripts (inbox.sh, content-im.sh) and explicitly forbids auto-archiving except on explicit keywords. The runtime instructions match what the scripts implement; they only read/write local JSON data and do not instruct reading unrelated system files or contacting external endpoints.

✓ Install Mechanism

No install spec (instruction-only) and included scripts are executed locally. There are no downloads or external installers. This is low-risk from an install mechanism perspective.

✓ Credentials

The skill requests no environment variables or credentials. It only requires the `jq` binary (declared in SKILL.md and enforced in scripts). No other secrets or unrelated system config are requested.

✓ Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide configs. It stores its data under its own data/ directory and sets file permissions (600) for created files.

版本历史

v0.1.5

Version 0.1.5 - Added an explicit instruction: only archive/save content if the user gives a clear command using keywords such as "archive", "save", "bookmark", "收录", "归档", "保存", "记录". - Updated documentation in both English and Chinese to emphasize NO auto-archiving; normal chat content (links, text, images) without these keywords will not be saved. - Improved natural language mapping tables to clarify required keywords for archiving actions.

v0.1.4

- Added homepage information to SKILL.md. - Declared jq as a required binary in SKILL.md. - Updated version to 0.1.4.

v0.1.3

- Replaced scripts/content.sh with scripts/content-im.sh to update script handling. - Updated internal data files: items.json and view-state.json. - SKILL.md updated to reflect current functionality and script changes. - Removed deprecated script to streamline skill maintenance.

v0.1.2

- List output is now more compact: URLs and media paths are only shown in the detail view, not in the main list. - IM output format updated in documentation for clarity on compact listing. - No changes to commands or data structure; interface and function remain the same. - Documentation improved to reflect new output format in both English and Chinese sections.

v0.1.1

- Updated to version 0.1.1. - Improved SKILL description for clarity and user motivation in both English and Chinese. - No functional or interface changes; documentation and metadata only.

v0.1.0

Initial release of Little Steve Content Inbox. - Provides a lightweight content archiving and review tool for IM workflows. - Supports archiving links, notes, and images from chat with simple commands. - Allows browsing archived content with pagination, and managing read/starred status. - Includes natural language command mapping for common actions (archive, list, mark read, delete, etc.). - Dual-language documentation (English & 中文) included.

元数据

Slug little-steve-content-inbox

版本 0.1.5

许可证 —

累计安装 1

当前安装数 1

历史版本数 6

常见问题