Docs: Update SKILL.md with correct API endpoints and working status

This commit is contained in:
Remora
2026-02-09 15:50:32 +01:00
parent 240671b84a
commit 3aafd4df13

View File

@@ -12,18 +12,18 @@ Comprehensive task management integration with Tududi (self-hosted task manageme
### Add a Task to Inbox
```bash
tududi-task-add --name "Task name" --description "Optional description"
scripts/quick-add.sh "Task name"
```
This adds to Tududi inbox immediately, no project/area required.
This creates a task in Tududi via `POST /api/v1/task` (returns uid).
### Read Inbox Status
### Read All Tasks
```bash
tududi-list-inbox
scripts/tududi-api.sh list-tasks
```
Returns count + summary of inbox tasks.
Returns tasks with filtering options.
### Get Task Suggestions
@@ -38,7 +38,7 @@ Example: "I want to add 'Setup CI/CD'. Suggest priority and project."
## Features
- **Inbox Management**: Quick add to inbox without project/area friction
- **Quick Task Creation**: Fast task capture via `POST /api/v1/task`
- **Smart Suggestions**: Analyze task descriptions and suggest priority/tags/projects
- **Daily Reminders**: Weekday mornings (Mon-Fri) for Pro area, custom for others
- **Status Checks**: Read inbox count, upcoming tasks, projects overview
@@ -46,37 +46,76 @@ Example: "I want to add 'Setup CI/CD'. Suggest priority and project."
## Bundled Scripts
See `scripts/` for Tududi API wrappers:
Located in `scripts/`:
- `tududi-api.sh` — Core API calls (create task, list, etc.)
- `quick-add.sh` — Create task via API endpoint (✅ Working)
- `tududi-api.sh` — Core API calls (list tasks, get metrics, etc.)
- `tududi-suggest.sh` — Analyze task & suggest priority/tags/projects
## Tududi API Endpoints
**Base URL**: `https://todo.dilain.com/api/v1`
**Task Operations**:
- `POST /task` — Create a new task → returns `{uid, name, ...}`
- `GET /tasks` — List tasks with filtering
- `GET /task/{id}` — Get task by ID/UID
- `PATCH /task/{id}` — Update task
- `DELETE /task/{id}` — Delete task
**Authentication**: Use header `Authorization: Bearer {API_KEY}`
## Environment Variables
Must be configured in OpenClaw gateway:
```
TUDUDI_API_URL=https://todo.dilain.com/api/v1
TUDUDI_API_KEY=tt_5e3ac7fc...
```bash
export TUDUDI_API_URL="https://todo.dilain.com/api/v1"
export TUDUDI_API_KEY="tt_5e3ac7fc2bf5ae5162ebac5d1d66dcc2ff9d9d0ab343b9d3d4c5a7c439ef67f5"
```
## Discord Integration
Daily reminder via cron job (separate configuration). Set schedule in openclaw.json:
Daily reminder via cron job. Configure in OpenClaw config:
```json
{
"cron": {
"jobs": [{
"schedule": { "kind": "cron", "expr": "0 8 * * 1-5" },
"name": "tududi-morning-reminder",
"schedule": { "kind": "cron", "expr": "0 8 * * 1-5", "tz": "Europe/Paris" },
"sessionTarget": "main",
"payload": {
"kind": "systemEvent",
"text": "[Tududi Reminder] Morning task check"
}
"text": "🎯 [Tududi] Morning task check: Show overdue + today's tasks"
},
"enabled": true
}]
}
}
```
Fires Mon-Fri at 8:00 AM (customize as needed).
Fires Mon-Fri at 8:00 AM Paris time.
## Testing
```bash
# Set credentials
export TUDUDI_API_URL="https://todo.dilain.com/api/v1"
export TUDUDI_API_KEY="tt_..."
# Test task creation
bash scripts/quick-add.sh "Test task"
# Expected: ✅ Added to Tududi: Test task (uid: xxxxx)
# Test list
bash scripts/tududi-api.sh list-tasks
```
## Status
- ✅ API connectivity verified
- ✅ Quick task creation working (POST /api/v1/task)
- ✅ Scripts tested with real API
- ⏳ "todo [task]" pattern matching (to be implemented in OpenClaw main agent)
- ⏳ Smart suggestions engine (tududi-suggest.sh)