功能描述

Manage Craft notes, documents, and tasks via CLI. Use when the user asks to add notes, create documents, manage tasks, search their Craft documents, or work with daily notes. Craft is a note-taking app for macOS/iOS.

使用说明 (SKILL.md)

Craft CLI

Name: Craft Notes
Author: noah-ribaudo

Interact with Craft.do documents, blocks, and tasks.

Setup

Install: Copy scripts/craft to ~/bin/craft and make executable
Get API URL from Craft: Settings > Integrations > Craft Connect > Create Link
Set env var: export CRAFT_API_URL='https://connect.craft.do/links/YOUR_LINK/api/v1'

Add to shell profile for persistence.

Commands

Documents

craft folders                    # List all folders
craft docs [location]            # List documents (unsorted, trash, templates, daily_notes)
craft doc \x3Cid>                   # Get document content by ID
craft daily [date]               # Get daily note (today, yesterday, YYYY-MM-DD)
craft search \x3Cterm>              # Search across documents
craft create-doc "Title" [folderId]  # Create new document

Blocks

craft add-block \x3CdocId> "markdown"      # Add block to document
craft add-to-daily "markdown" [date]    # Add to daily note (default: today)
craft update-block \x3CblockId> "markdown" # Update existing block
craft delete-block \x3CblockId>...         # Delete block(s)

Tasks

craft tasks [scope]              # List tasks (inbox, active, upcoming, logbook)
craft add-task "text" [scheduleDate]  # Add task to inbox
craft complete-task \x3Cid>         # Mark task as done
craft delete-task \x3Cid>           # Delete task

Collections

craft collections                # List all collections
craft collection-items \x3Cid>      # Get items from collection

Notes

Markdown content passed as arguments; escape quotes if needed
Dates: today, yesterday, or YYYY-MM-DD
Task scopes: inbox (default), active, upcoming, logbook
Document locations: unsorted, trash, templates, daily_notes

安全使用建议

This skill looks like a normal Craft CLI wrapper but has packaging and metadata inconsistencies you should resolve before installing. Specifically: - The SKILL.md asks you to set CRAFT_API_URL (this is the Craft Connect link/token used to access your data), but the skill metadata does not declare that env var — treat that as a sensitive credential. Do not paste your link/token into anything you haven't reviewed. - The metadata references an install script at scripts/craft that is not included in the bundle. Ask the publisher for the script source or the full package. Do not install a script you haven't inspected; an executable placed in ~/bin runs with your user privileges and can access your files. - If you decide to proceed, request the install script content and review it to ensure it only calls the Craft API and does not exfiltrate other data. Prefer installing manually by following the SKILL.md steps rather than running an unattended installer. If you cannot obtain the missing script or a trustworthy source, treat this skill as untrusted. If the publisher provides the script, verify it only uses the declared CRAFT_API_URL and does not read other credentials or arbitrary files.

功能分析

Type: OpenClaw Skill Name: craft Version: 1.0.0 The skill bundle describes a legitimate purpose: managing Craft notes via a CLI tool. The `SKILL.md` file provides instructions for installing a local script (`scripts/craft`) and setting up an API URL. No malicious prompt injection attempts, data exfiltration, or other harmful behaviors are present in the provided `_meta.json` or `SKILL.md` files. The `scripts/craft` file itself is not included in the provided content, so its specific actions cannot be analyzed, but the instructions for its use are benign.

能力评估

⚠ Purpose & Capability

The skill claims to manage Craft documents via a CLI which legitimately requires a Craft Connect URL/token. However the package declares no required environment variables or primary credential even though the SKILL.md instructs the user to set CRAFT_API_URL. That mismatch suggests metadata is incomplete or incorrect.

⚠ Instruction Scope

Runtime instructions tell the agent/user to copy scripts/craft to ~/bin/craft and to set CRAFT_API_URL. The instructions do not ask for unrelated system files, but they reference a script path (scripts/craft) that is not present in the bundle, and they rely on an environment variable not declared elsewhere.

⚠ Install Mechanism

The embedded metadata includes an install action that would copy a script into ~/bin (potentially adding an executable to the user's PATH). No install spec files are present in the bundle — the referenced scripts/craft file is missing. An install that writes/executes an unknown script is a risk; lack of the script here is an incoherence (either the skill was packaged incompletely or metadata is misleading).

⚠ Credentials

The SKILL.md explicitly requires CRAFT_API_URL (which contains access credentials to the user's Craft data) but the skill declares no required env vars or primary credential. Sensitive data is implied but not declared, which prevents automated reviewers from knowing the skill needs secrets.

ℹ Persistence & Privilege

The skill is not marked always:true and does not request elevated OS privileges. The only persistence implied is installing a script to ~/bin, which is a typical user-level modification but should be inspected before installing.

版本历史

v1.0.0

Initial release: Craft.do CLI for documents, blocks, tasks, and collections

元数据

Slug craft

版本 1.0.0

许可证 —

累计安装 4

当前安装数 3

历史版本数 1

常见问题

Craft Notes 是什么？

Manage Craft notes, documents, and tasks via CLI. Use when the user asks to add notes, create documents, manage tasks, search their Craft documents, or work with daily notes. Craft is a note-taking app for macOS/iOS. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2140 次。

如何安装 Craft Notes？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install craft」即可一键安装，无需额外配置。

Craft Notes 是免费的吗？

是的，Craft Notes 完全免费（开源免费），可自由下载、安装和使用。

Craft Notes 支持哪些平台？

Craft Notes 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Craft Notes？

由 Noah-Ribaudo（@noah-ribaudo）开发并维护，当前版本 v1.0.0。

Craft Notes