pin-asana-projects

name	pin-asana-projects
description	Use this skill when pinning repo Asana projects to `.agents/cyber-asana.json` via keyword search.

Pin Asana Projects

When to use

When the user wants to pin Asana projects to this repo — a commit-friendly name → GID map in .agents/cyber-asana.json for init, onboarding, or when the file is missing or stale.

Requires ASANA_TOKEN and ASANA_WORKSPACE (see init-asana). When using npx, pin <exact> with npm view cyber-asana version (same rule as init-asana).

Instructions

1. Gather search keywords

Ask the user which projects belong in this repo. Derive one or more keywords from:

• Project names or fragments they mention
• Repo or package name (e.g. cyber-asana)
• Team or product names tied to the codebase

Use short, distinctive fragments — not full sentences.

2. Search for projects

For each keyword, search the workspace (requires ASANA_WORKSPACE or --workspace-gid):

cyber-asana project search "<keyword>" --toon
# or, if using npx without global install:
npx cyber-asana@<exact> project search "<keyword>" --toon

Prefer active work when the user did not ask for archived projects:

cyber-asana project search "<keyword>" --no-completed --toon

Read the { gid, name } rows from the output (--toon is token-efficient; use --json for raw JSON). Deduplicate by across keyword searches.