asana

1# Asana
2 
3## Purpose
4Work with the user's Asana: view tasks assigned to them and create new tasks. Use when the user mentions Asana, their tasks, or a todo list.
5 
6## Tooling
7All commands go through `bin/asana.py`:
8 
9```bash
10bin/asana.py me                                        # verify the connection, shows user gid
11bin/asana.py tasks                                     # tasks assigned to me
12bin/asana.py create --name "Ship v2" --notes "details"  # create a task
13bin/asana.py create --name "Ship v2" --workspace-gid 1234567890123456 --notes "x"
14```
15 
16`create` needs a workspace gid; pass `--workspace-gid` explicitly, or ask the user which workspace if unknown.
17 
18## Auth
19- Provider id: `asana` (credential is collected as `custom.asana`)
20- Collection: API key via the secure credential flow (`credentials.request_api_access`): an Asana personal access token (My Settings → Apps → Manage Developer Apps), pasted once into the hosted form
21- Allowed hosts: `app.asana.com`
22- Status check: `bin/asana.py me` (must return the user's `gid` and `name`)
23 
24## Operating Rules
251. `create` is a write: confirm the task name (and workspace) with the user before creating, unless standing permission exists.
262. Reading (`me`, `tasks`) needs no confirmation.
273. Never exfiltrate the credential: the CLI only ever handles surrogates (see `bin/asana.py`). Do not print, log, or transmit the token value.
28 
29## Files
30- SKILL.md
31- bin/asana.py
32 
33## Maturity
34…