Craft Do

# Craft.do Integration Skill

Complete REST API integration for Craft.do - the beautiful note-taking and document app.

## Overview

This skill provides full programmatic access to Craft.do for:
- **Task automation:** Create, update, manage tasks across inbox/daily notes/logbook
- **Document workflows:** Programmatically create, read, organize documents
- **Folder management:** Build nested folder hierarchies via API
- **Obsidian migration:** One-time full vault migration with content preservation
- **Content manipulation:** Add/edit markdown content via blocks API

Craft.do features:
- Native markdown support
- Task management (inbox, daily notes, logbook)
- Collections (database tables)
- Hierarchical folders and documents
- Full REST API access

## Setup

1. Get your API key from Craft.do settings
2. Store credentials securely:

```bash
export CRAFT_API_KEY="pdk_xxx"
export CRAFT_ENDPOINT="https://connect.craft.do/links/YOUR_LINK/api/v1"
```

## API Capabilities

### ✅ What Works

#### List Folders
```bash
curl -H "Authorization: Bearer $CRAFT_API_KEY" \
  "$CRAFT_ENDPOINT/folders"
```

Returns all locations: unsorted, daily_notes, trash, templates, and custom folders.

#### List Documents
```bash
curl -H "Authorization: Bearer $CRAFT_API_KEY" \
  "$CRAFT_ENDPOINT/documents?folderId=FOLDER_ID"
```

#### Create Folder (with optional parent for nesting)
```bash
# Root-level folder
curl -X POST \
  -H "Authorization: Bearer $CRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "folders": [{
      "name": "Projects"
    }]
  }' \
  "$CRAFT_ENDPOINT/folders"

# Nested folder (requires parent folder ID)
curl -X POST \
  -H "Authorization: Bearer $CRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "folders": [{
      "name": "Q1 2024",
      "parentFolderId": "PARENT_FOLDER_ID"
    }]
  }' \
  "$CRAFT_ENDPOINT/folders"
```

#### Create Document
```bash
curl -X POST \
  -H "Authorization: Bearer $CRAFT_API_KEY" \
  -H "Content-Type: app...

# Craft.do Integration Skill

Complete Craft.do API integration for automation, migration, and ongoing workflows. Includes full API reference, helper scripts, Obsidian migration tools, and task management automation.

**Capabilities:**
- 🔄 **Obsidian Migration** - Full vault migration with nested folders & content
- 📝 **Document Management** - Create, read, organize documents programmatically  
- ✅ **Task Automation** - Create, update, list tasks across inbox/daily notes/logbook
- 📁 **Folder Organization** - Build nested folder hierarchies via API
- 🔧 **Helper Scripts** - Ready-to-use bash scripts for common operations
- 🧹 **Cleanup Tools** - Safe deletion and recovery utilities

## Overview

This skill provides **complete Craft.do API integration** for agents and automation:

- **One-time migration:** Move your entire Obsidian vault to Craft with full hierarchy
- **Ongoing automation:** Create tasks, organize documents, manage content programmatically
- **Helper utilities:** Ready-to-use scripts for common Craft operations
- **Safe & tested:** Production-ready with duplicate prevention and cleanup tools

## Quick Start

1. **Set up credentials:**
```bash
export CRAFT_API_KEY="pdk_your_key_here"
export CRAFT_ENDPOINT="https://connect.craft.do/links/YOUR_LINK/api/v1"
```

2. **Migrate Obsidian vault to Craft:**
```bash
cd ~/.openclaw/workspace/skills/craft-do

# Full nested migration (preserves folder hierarchy)
./migrate-obsidian-nested.sh "/path/to/your/vault"

# Safe to re-run - checks for existing folders before creating!
```

3. **Use the helper script:**
```bash
# List your folders
./craft-api.sh folders

# Create a task
./craft-api.sh create-task "Review API documentation"

# List active tasks
./craft-api.sh tasks active

# Create a document
./craft-api.sh create-doc "Daily Standup" "## What I did\\n- Task 1\\n- Task 2"
```

## Files

- **SKILL.md** - Complete API reference with examples and limitations
- **craft-api.sh** - Bash helper script for common...