asana-reader

Read Asana task details and comments by URL, ID, or name search.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/SuperCorks/agent-skills --skill asana-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asana-reader
Source: https://github.com/SuperCorks/agent-skills/tree/main/asana-reader
Command: npx skills add https://github.com/SuperCorks/agent-skills --skill asana-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires asana, and includes scripts (resource) components.

What problem does it solve?

This Skill consolidates the tedious task of retrieving Asana task details and comments across multiple workspaces and accounts by providing a simple CLI interface that reads data from URLs, IDs, or name searches.

Core Features & Use Cases

  • Read task details by URL, ID, or name search across multiple accounts using ASANA_ACCOUNTS.
  • Retrieve task metadata, comments, custom fields, subtasks, and related projects for comprehensive context.
  • Multi-account support with per-account selection via --account and clear error handling when credentials are missing or ambiguous.
  • Quick access to workspace and project information by listing workspaces or projects as needed.

Quick Start

  • Install dependencies and run the read-task script:
  • node scripts/read-task.js --url "https://app.asana.com/0/1234567890/9876543210"
  • node scripts/read-task.js --id 9876543210 --account personal

Frequently Asked Questions about asana-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read Asana task details and comments using a CLI?

The script provides a Node.js CLI interface to read Asana tasks and comments by URL, ID, or name search. It retrieves task metadata, custom fields, and subtasks directly in your terminal using the Asana SDK.

Can I read Asana tasks across multiple accounts and workspaces?

Yes, reading Asana tasks across multiple accounts is supported by setting the ASANA_ACCOUNTS environment variable. You select a specific workspace during execution using the --account flag.

Do I need Node.js and the Asana SDK to retrieve task information?

Yes, Node.js and the Asana SDK are required dependencies. The CLI script uses them to authenticate requests, resolve accounts, and normalize task data retrieved from workspaces.

What is the best way to fetch Asana task data by URL or ID?

Using a dedicated CLI script is the best way to fetch Asana task data by URL or ID. It parses links, resolves identifiers, normalizes results, and provides comprehensive error handling for read-only workspace access.

What happens if Asana credentials are missing when querying tasks?

When credentials are missing or ambiguous, the CLI provides clear error handling via SkillError. This stops execution and gives specific feedback about account resolution failures before task data retrieval proceeds.