Description

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.

README (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

Usage Guidance

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.

Capability Analysis

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.

Capability Assessment

⚠ 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.

Version History

v1.0.0

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

Metadata

Slug craft

Version 1.0.0

License —

All-time Installs 4

Active Installs 3

Total Versions 1

Frequently Asked Questions

What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 2140 downloads so far.

How do I install Craft Notes?

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

Is Craft Notes free?

Yes, Craft Notes is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Craft Notes support?

Craft Notes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Craft Notes?

It is built and maintained by Noah-Ribaudo (@noah-ribaudo); the current version is v1.0.0.

More Skills

Craft Notes