# Effortlist AI

> Manage EffortList AI folders, tasks, and todos. Use when the user wants to organize their life, track projects, or manage schedules via the EffortList AI platform. Supports full CRUD operations, cascading deletes, and atomic undo/redo history for data integrity.

- Skill: `johnalbertini14-glitch/effortlist-ai` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/effortlist-ai`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/effortlist-ai/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/johnalbertini14-glitch/effortlist-ai

---


# 📋 EffortList AI (Universal Skill)

## 🌟 Value Proposition (For Humans)

EffortList AI is a sophisticated life-management platform that merges advanced Generative AI with a robust, deterministic scheduling engine. Use this skill to give your agent full control over your project organization, time protection, and project lifecycles.

## 🚀 Setup & Authentication

1. **Subscription:** Requires a developer subscription ($5/month) at [effortlist.io](https://www.effortlist.io).
2. **API Key:** Generate a **Persistent API Key** in Developer Settings.
3. **Storage:** Provide the key via the `EFFORTLIST_API_KEY` environment variable or OpenClaw internal config (`openclaw config set skills.entries.effortlist-ai.env.EFFORTLIST_API_KEY "your_key"`).

## 📐 Mental Model (Data Hierarchy)

EffortList AI operates on a strictly nested hierarchy:
**Folder (Container)** ──> **Task (Project)** ──> **Todo (Actionable Slot)**

- **Folders:** Optional top-level containers for grouping related projects.
- **Tasks:** Actionable projects that can be top-level or nested in a Folder.
- **Todos:** Granular actionable steps. **Every Todo MUST have a parent Task.**

## 🤖 Intelligence & Mapping (For Agents)

| User Intent      | Agent Workflow                     | Endpoint Goal                                              |
| :--------------- | :--------------------------------- | :--------------------------------------------------------- |
| "Plan a project" | Create Folder -> Tasks -> Todos    | `POST /folders`, `POST /tasks`, `POST /todos`              |
| "Fix my mistake" | Fetch History -> Target ID -> Undo | `GET /api/v1/undo`, `POST /api/v1/undo?id=...`             |
| "Show my day"    | Fetch Todos by Date Range          | `GET /api/v1/todos?from=...&to=...`                        |
| "Surgical Edit"  | Patch update a specific record     | `PATCH /api/v1/{type}?id=...`                              |

## 🛠️ Execution Logic (The "Omni" Way)

1. **Surgical Patching:** When updating a record (e.g., adding a description or marking complete), always use the `PATCH` method with the record `?id=`. This is more efficient than a full replacement.
2. **Contextual Awareness:** If a task is "orphaned" (no folder), proactively check `GET /api/v1/folders` and suggest an existing one if it seems relevant before creating a new one.
3. **Cascading Safety:** Always remind the user that deleting a Folder or Task is an **Atomic Purge** that cleans up all sub-records.
4. **Reminders vs. Todos:** Reminders (`isReminder: true`) are notifications; Todos (`false`) are actionable work that occupies time slots and can be "overdue."

## 🔒 Security & Privacy (Zero Trust)

- **Data Isolation:** Strict row-level security; users only see their own data.
- **Encryption:** AES-256 at rest; TLS 1.3 in transit.
- **AI Privacy:** Your personal data is **never** used to train models.

## 📖 Deep References

- **Full API Reference:** [API Enpoints Docs](https://www.effortlist.io/docs)
- **Security Audit Docs:** [Security](https://www.effortlist.io/security)

**Project Version:** 1.7.1