📋 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
- Subscription: Requires a developer subscription ($5/month) at effortlist.io.
- API Key: Generate a Persistent API Key in Developer Settings.
- Storage: Provide the key via the
EFFORTLIST_API_KEYenvironment 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)
- Surgical Patching: When updating a record (e.g., adding a description or marking complete), always use the
PATCHmethod with the record?id=. This is more efficient than a full replacement. - Contextual Awareness: If a task is "orphaned" (no folder), proactively check
GET /api/v1/foldersand suggest an existing one if it seems relevant before creating a new one. - Cascading Safety: Always remind the user that deleting a Folder or Task is an Atomic Purge that cleans up all sub-records.
- 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
- Security Audit Docs: Security
Project Version: 1.7.1