sync-asana-project

name	sync-asana-project
description	Use this skill when pulling Asana project tasks into local markdown for offline planning or documentation.

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.