Sync Asana Project

Use this skill when pulling Asana project tasks into local markdown for offline planning or documentation.

cyberuni 64592da 2 files · 1.9 KB Updated

File contents

Sync Asana Project

When to use

When the user wants a local snapshot of an Asana project's tasks — for sprint planning, attaching context to a codebase, or working offline.

Instructions

1. Identify the project

If the user hasn't specified a project GID, search for it (requires ASANA_WORKSPACE or --workspace-gid):

If they gave a project name or fragment:

cyber-asana project search "<name or fragment>" --toon

Otherwise search active projects:

cyber-asana project search --no-completed --toon

Read the output and ask the user to pick one. (--toon is the token-efficient format; use --json for raw JSON.)

2. Export to markdown

cyber-asana project export <project-gid> --output <path>

For example: --output docs/sprint.md or --output TASKS.md.

Omit --output to preview markdown on stdout first.

3. Confirm

Tell the user the file path written. Suggest re-running after each sprint to refresh.

cyberuni/cyber-asana/tree/main/packages/cyber-asana/skills/sync-asana-project commit 64592da88b

Frequently asked questions

npx skillmds@latest add cyberuni/sync-asana-project