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 ### Add a Task to Inbox
```bash ```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 ```bash
tududi-list-inbox scripts/tududi-api.sh list-tasks
``` ```
Returns count + summary of inbox tasks. Returns tasks with filtering options.
### Get Task Suggestions ### Get Task Suggestions
@@ -38,7 +38,7 @@ Example: "I want to add 'Setup CI/CD'. Suggest priority and project."
## Features ## 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 - **Smart Suggestions**: Analyze task descriptions and suggest priority/tags/projects
- **Daily Reminders**: Weekday mornings (Mon-Fri) for Pro area, custom for others - **Daily Reminders**: Weekday mornings (Mon-Fri) for Pro area, custom for others
- **Status Checks**: Read inbox count, upcoming tasks, projects overview - **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 ## 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-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 ## Environment Variables
Must be configured in OpenClaw gateway: Must be configured in OpenClaw gateway:
``` ```bash
TUDUDI_API_URL=https://todo.dilain.com/api/v1 export TUDUDI_API_URL="https://todo.dilain.com/api/v1"
TUDUDI_API_KEY=tt_5e3ac7fc... export TUDUDI_API_KEY="tt_5e3ac7fc2bf5ae5162ebac5d1d66dcc2ff9d9d0ab343b9d3d4c5a7c439ef67f5"
``` ```
## Discord Integration ## Discord Integration
Daily reminder via cron job (separate configuration). Set schedule in openclaw.json: Daily reminder via cron job. Configure in OpenClaw config:
```json ```json
{ {
"cron": { "cron": {
"jobs": [{ "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", "sessionTarget": "main",
"payload": { "payload": {
"kind": "systemEvent", "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)