Openclaw Yatta Skill

# Yatta! Skill

Interact with Yatta! task management system via API. Requires an API key from your Yatta! account.

## ⚠️ Security Warning

**This skill can perform DESTRUCTIVE operations on your Yatta! account:**

- **Task Management:** Create, update, archive, and batch-modify tasks
- **Project Management:** Create, update, and archive projects
- **Context Management:** Create contexts and assign them to tasks
- **Comment Management:** Add, update, and delete task comments
- **Calendar Management:** Create, sync, and modify calendar subscriptions
- **Follow-Up Management:** Update delegation schedules and mark complete
- **Capacity Management:** Trigger capacity computations

**Operation Types:**

**Read-Only Operations** (✅ Safe):
- List tasks, projects, contexts, comments
- Get analytics, insights, streaks
- View capacity and calendar data
- Get Eisenhower Matrix view
- All GET requests

**Destructive Operations** (⚠️ Modify or delete data):
- Create/update/archive tasks (POST, PUT, DELETE)
- Batch update tasks
- Create/update projects
- Create/assign contexts
- Add/update/delete comments
- Add/sync calendar subscriptions
- Update follow-up schedules
- All POST, PUT, DELETE requests

**Best Practices:**
1. **Review commands before running** - Check what the API call will do
2. **No undo for deletions** - Archived tasks can be recovered, but some operations are permanent
3. **Test on non-critical data first** - Create test tasks/projects to verify behavior
4. **Batch operations affect multiple items** - Be extra careful with batch updates
5. **Real-time sync** - Changes appear in Yatta! UI immediately

For detailed API operation documentation, see [API-REFERENCE.md](API-REFERENCE.md).

## Setup

### ⚠️ API Key Security

**Your Yatta! API key provides FULL access to your account:**
- Can create, read, update, and delete ALL tasks, projects, contexts
- Can modify calendar subscriptions and follow-up schedules
- Can archive data and trigger computations
- **No read...

# Yatta! Skill for OpenClaw

> Manage Yatta! tasks, projects, contexts, and productivity tracking from OpenClaw (Clawdbot/Moltbot)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Overview

This skill enables OpenClaw agents to interact with [Yatta!](https://yattadone.com), a time-aware task management system. Manage tasks, track delegation, monitor capacity, and get productivity insights—all via API.

**Status:** ✅ **Tested and Verified** (Feb 10, 2026)  
**Real-time Sync:** ✅ API changes appear in UI immediately

## Features

✅ **Full Task Management** - Create, update, complete, and archive tasks  
✅ **Project Organization** - Group related tasks into projects  
✅ **Context Tagging** - Tag tasks with contexts (@work, @home, etc.)  
✅ **Delegation Tracking** - Delegate tasks with automated follow-up reminders  
✅ **Calendar Integration** - View calendar events and capacity  
✅ **Capacity Monitoring** - Track daily capacity and avoid overbooking  
✅ **Analytics** - Get productivity insights, velocity metrics, and streaks  
✅ **Matrix View** - Eisenhower Matrix (do-first, schedule, delegate, eliminate)

## Security

**This skill includes comprehensive security controls:**

- **🔒 Autonomous invocation disabled** - Requires explicit user commands
- **📋 Capability declarations** - Clear documentation of destructive operations
- **🔑 Credential documentation** - API key requirements and security best practices
- **📚 Operation classification** - 24 read-only, 12 destructive operations documented
- **⚠️ Security warnings** - Prominent warnings about data-modifying operations
- **📖 Comprehensive docs** - [API-REFERENCE.md](API-REFERENCE.md) with side effects, undo procedures

**API Key Access:**
- Your Yatta! API key provides full account access
- Store securely (1Password CLI, environment variables)
- Rotate regularly (every 90 days recommended)
- Never commit keys to version control

See [SKILL...