← Back to Skills Marketplace
yanguangzhe-collab

Bucket List

by hujiudao-collab · GitHub ↗ · v1.4.0 · MIT-0
cross-platform ✓ Security Clean
186
Downloads
0
Stars
0
Active Installs
11
Versions
Install in OpenClaw
/install bucket-list
Description
Use this skill when the user wants to record, view, update, complete, cancel, or review a personal bucket list / wish list. Supports Chinese commands such as...
README (SKILL.md)

愿望清单 (Bucket List)

记录主人与龙虾一起完成的人生愿望清单。它不是待办软件,也不是人生导师;它是一个本地优先的愿望记录和成就回顾工具。

When To Use

Use this skill when the user asks to:

  • add a wish, bucket-list item, life goal, or "愿望"
  • view pending, completed, or cancelled wishes
  • mark a wish completed or cancelled
  • review completed wishes or shared achievements
  • open or maintain the bucket-list GUI
  • import, export, or repair bucket-list data

Quick Start

Start the GUI:

cd skills/bucket-list
node server.js
# open http://localhost:9999/

Use the CLI:

./bucket-list.sh add "去南极看企鹅" "旅行"
./bucket-list.sh view
./bucket-list.sh complete "南极" "看到了企鹅"
./bucket-list.sh cancel "学吉他" "改学钢琴"
./bucket-list.sh achievements

Natural-language entry:

./bucket-list.sh intent "添加愿望:去南极看企鹅"
./bucket-list.sh intent "查看愿望清单"
./bucket-list.sh intent "完成了 发布技能"
./bucket-list.sh intent "我们完成了什么"

Data

The runtime data file is stored outside the skill folder:

\x3Cworkspace>/data/bucket-list.json

The published data/bucket-list.json inside this skill is only an empty template. Do not publish personal wishes in the package.

Canonical wish fields:

  • id
  • content
  • category
  • status: pending, completed, or cancelled
  • createdAt
  • endedAt
  • endedBy
  • completionNote
  • cancelReason
  • timeline

Safety

  • The server binds to 127.0.0.1 only.
  • The server only accepts same-origin browser writes by default.
  • Writes are validated, size-limited, and saved atomically with a backup.
  • The CLI uses Node JSON parsing/writing instead of shell text edits.

Boundaries

  • Do not treat ordinary tasks as wishes unless the user frames them as a wish, life goal, or bucket-list item.
  • Ask before recording sensitive or emotionally loaded content if the user's intent is unclear.
  • Strong negative emotion should receive care first; record or update wishes only after the user confirms.
Usage Guidance
This skill appears to be a harmless local bucket-list manager. Before installing: 1) note it will create/read/write <workspace>/data/bucket-list.json (or the file you set via BUCKET_LIST_DATA_FILE) — don't store secrets there. 2) The server binds to 127.0.0.1, but the implementation accepts POSTs that lack an Origin header (so local tools like curl or other local services can POST); if you need stricter protections, run it behind a firewall or avoid starting the server. 3) You can change the port with BUCKET_LIST_PORT and the data file with BUCKET_LIST_DATA_FILE. 4) Review the bundled files if you have sensitive data concerns; no external network endpoints or credential requests are present.
Capability Analysis
Type: OpenClaw Skill Name: bucket-list Version: 1.4.0 The bucket-list skill is a legitimate tool for managing personal goals via a CLI and a local web GUI. The code implements a local Node.js server (server.js) restricted to 127.0.0.1 with basic path traversal protections and same-origin checks. Data management (scripts/bucket-list-data.js) is handled through structured JSON operations with atomic writes, and no evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: CLI, local HTTP GUI, and JSON data storage. The skill legitimately needs filesystem access to a workspace data file and provides a CLI/server to manage that data.
Instruction Scope
SKILL.md instructs running node server.js and the CLI, which is consistent with the code. Implementation detail divergence: the docs state "server only accepts same-origin browser writes by default", but the server's isSameOrigin() returns true when the Origin header is absent — meaning non-browser local POSTs (curl, local services without Origin) will be accepted. The skill also reads/writes a workspace-level data file (documented), which is expected for this purpose.
Install Mechanism
No install spec; this is an instruction-only skill with bundled scripts — nothing is downloaded from external URLs and no packages are installed during skill install.
Credentials
No credentials requested (good). The code does read optional env vars (BUCKET_LIST_DATA_FILE and BUCKET_LIST_PORT) but the SKILL.md does not declare these environment variables in the requirements section — they are reasonable optional overrides but users should be aware they exist.
Persistence & Privilege
always is false; the skill does not modify other skills or global agent settings. It writes data to a workspace data path (creates backups) which is appropriate for a local data management tool.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bucket-list
  3. After installation, invoke the skill by name or use /bucket-list
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.0
Clean public template data, standardize skill metadata, unify JSON handling through Node, harden localhost server writes, and fix GUI validation/timeline behavior.
v1.3.1
- 路径已统一,数据访问和存储更加一致。 - 增加了数据验证,避免无效数据写入。 - 文档说明同步更新,更准确描述功能和流程。
v1.3.0
Version 1.3.0 brings collaborative support and a local HTTP server. - 新增 server.js,支持以 HTTP 服务形式访问,仅限 localhost。 - GUI 和 CLI 入口共同读写同一份愿望清单数据,实现主人与龙虾协作。 - 更新文档,详细说明协作模式、服务器用法及数据流转。 - 强化数据安全,仅本地访问,无外网依赖。
v1.2.3
- 移除 server.js,取消 HTTP 服务,采用纯本地存储,无需网络依赖。 - bucket-list.html 改为用浏览器 localStorage 保存数据,实现离线安全使用。 - 精简功能聚焦愿望记录与进度追踪,删除“协作”(双端写同一 json)相关说明。 - 添加数据导出/导入备份功能,增强数据自主可控性。 - 更新文档说明,反映新的本地化和安全特性。
v1.2.2
- 更新了文件结构说明,去除了 index.js、data.js、renderer.js 等已不在目录中的文件 - 文件结构部分调整,更加准确反映现有目录结构 - 未涉及功能、命令等内容变更
v1.2.1
No user-facing changes in this version. - Version incremented to 1.2.1. - No file changes detected; functionality and documentation remain the same.
v1.2.0
Version 1.2.0 summary: Major update—unifies CLI and GUI data, introduces an HTML interface and local server. - Web GUI added: Access via browser with a new Node.js server (server.js, bucket-list.html). - All data is now shared between CLI (龙虾) and the web GUI—both read and write the same JSON file for real-time collaboration. - File structure simplified: old GUI and related scripts removed; new HTML/JS files added. - SKILL.md updated to reflect changes in workflow, commands, and data sharing model. - Shell script and CLI interaction retained; enhanced documentation for both entry points.
v1.1.2
安全审查修复:路径统一(workspace/data/),删除server.js(gateway serve),gui.html字段同步v1.1
v1.1.1
修复SKILL.md文档不一致问题,新增编辑/分类命令,8类关键词自动识别,数据结构重构
v1.1.0
安全修复:绑定127.0.0.1、路径安全检查、修复代码bug、移除测试数据
v1.0.0
一起探索世界的伙伴。启动系统集成:每次启动都知道你的愿望。工作引导:龙虾主动参考愿望分配任务。情绪陪伴:低谷时提振士气。情绪触发功能:流程层+视角层+B方案+C方案。伙伴定位:主动加载、实时匹配、情绪陪伴、一起探索世界。
Metadata
Slug bucket-list
Version 1.4.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 11
Frequently Asked Questions

What is Bucket List?

Use this skill when the user wants to record, view, update, complete, cancel, or review a personal bucket list / wish list. Supports Chinese commands such as... It is an AI Agent Skill for Claude Code / OpenClaw, with 186 downloads so far.

How do I install Bucket List?

Run "/install bucket-list" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bucket List free?

Yes, Bucket List is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Bucket List support?

Bucket List is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Bucket List?

It is built and maintained by hujiudao-collab (@yanguangzhe-collab); the current version is v1.4.0.

💬 Comments