How do I install the Effortlist AI skill?

Run npx skillmds@latest add dvcrn/effortlist-ai in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Effortlist AI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Effortlist AI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Effortlist AI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Effortlist AI?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Effortlist AI by dvcrn — Agent Skill

Name: Effortlist AI
Rating: 4.2 (5 reviews)
Author: dvcrn

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.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

📋 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: Human user must generate a Persistent API Key in Developer Settings.
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)

Surgical Extraction & Patching: Always prefer fetching a specific record by its ID (GET ?id=...) over broad list fetches. When updating, use PATCH with the record ?id=.
Phase-Aware Scheduling: Be mindful of the 5-phase Omni processing loop (Temporal Resolution, Decomposition, Parallel Reasoning, Synthesis, and Break Validation). Proactively flag events with isProtectedTime: true to trigger the server-side safety net.
Cascading Safety: Be aware that deleting a Folder or Task is an Atomic Purge. However, the engine protects items that are simultaneously being updated from accidental deletion.
Human Factors: When proposing schedules, apply "Gap-First Placement" and "Human Factor" rules (e.g., leaving space for transitions).

🔒 Security & Privacy (Zero Trust)

Data Isolation: Strict row-level security; users only see their own data.
AI Privacy: Your personal data is never used to train models.

📖 Deep References

Full API Reference: API DOCs
Omni Architecture: (Located in references/architecture.md)
Security Audit Docs: SECURITY

Project Version: 1.7.5

---name: effortlist-aidescription: 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.---# 📋 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 & Authentication1. **Subscription:** Requires a developer subscription ($5/month) at [effortlist.io](https://www.effortlist.io).2. **API Key:** Human user must 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 Extraction & Patching:** Always prefer fetching a specific record by its ID (`GET ?id=...`) over broad list fetches. When updating, use `PATCH` with the record `?id=`.2. **Phase-Aware Scheduling:** Be mindful of the 5-phase Omni processing loop (Temporal Resolution, Decomposition, Parallel Reasoning, Synthesis, and Break Validation). Proactively flag events with `isProtectedTime: true` to trigger the server-side safety net.3. **Cascading Safety:** Be aware that deleting a Folder or Task is an **Atomic Purge**. However, the engine protects items that are simultaneously being updated from accidental deletion.4. **Human Factors:** When proposing schedules, apply "Gap-First Placement" and "Human Factor" rules (e.g., leaving space for transitions).## 🔒 Security & Privacy (Zero Trust)- **Data Isolation:** Strict row-level security; users only see their own data.- **AI Privacy:** Your personal data is **never** used to train models.## 📖 Deep References- **Full API Reference:** [API DOCs](https://www.effortlist.io/docs)- **Omni Architecture:** (Located in references/architecture.md)- **Security Audit Docs:** [SECURITY](https://www.effortlist.io/security)**Project Version:** 1.7.5

Frequently asked questions