A dependency-free Node.js CLI skill for managing Asana tasks, projects, briefs, and timelines via Personal Access Tokens.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install asana-agent-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install asana-agent-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Asana?
The Asana skill for Openclaw Skills provides a powerful, automation-first interface to the Asana REST API (v1). Designed for developers and AI agents, it allows for seamless management of complex project structures without the overhead of heavy dependencies. By utilizing a Personal Access Token (PAT), it grants the agent secure access to workspaces, tasks, and project metadata.
This skill is particularly valuable for teams looking to bridge the gap between their development environment and project management tracking. It handles everything from simple task creation to advanced Project Manager workflows, such as updating project briefs, tracking dependencies, and managing custom fields, all while returning clean JSON output suitable for further programmatic processing.
Asana Use Cases
- Automating weekly status updates and project briefs based on repository activity.
- Searching and filtering tasks using advanced criteria like assignee, completion status, and custom dates.
- Bulk shifting project timelines and task due dates during sprint planning.
- Managing complex task dependencies and blockers within a project graph.
- Uploading file attachments and embedding inline images into project documentation automatically.
How Asana Works
- The skill initializes by authenticating via the ASANA_PAT environment variable provided through the Openclaw Skills configuration.
- It utilizes a typeahead and resolution system to convert human-readable names into Global Identifiers (GIDs) required by the Asana API.
- Commands are executed via a Node.js script that translates CLI arguments into structured API requests.
- For rich text operations, the skill ensures that HTML fragments are XML-valid and properly wrapped in body tags to satisfy Asana's strict formatting requirements.
- It supports incremental updates through an events endpoint, using locally stored sync tokens to fetch only the latest changes since the last run.
Asana Setup
To get started with Asana for Openclaw Skills, follow these steps:
- Generate a Personal Access Token (PAT) in your Asana Developer Console.
- Enable the skill and securely store your token using the CLI:
openclaw config set skills.entries.asana.enabled true
openclaw config set skills.entries.asana.apiKey "YOUR_ASANA_PAT_HERE"
- Verify your identity and list available workspaces to ensure connectivity:
node scripts/asana.mjs me
node scripts/asana.mjs workspaces
Asana Data Schema & Taxonomy
The skill interacts with several Asana data primitives, returning results in structured JSON. Key data types include:
| Object Type | Key Attributes | Purpose |
|---|---|---|
| Task | GID, name, notes, assignee, due_on | Primary unit of work management |
| Project | GID, name, workspace, custom_field_settings | Container for related tasks |
| Custom Field | GID, name, type (enum/number/text) | Structured metadata for tasks |
| Event | resource, type, action, created_at | Tracking incremental changes |
| Project Brief | GID, title, html_text | High-level project documentation |
Asana Advanced Features
- Timeline shifting: Bulk adjust task dates across an entire project with dry-run protection.
- Reliable Mentions: Implements a specific 'add follower + wait' pattern to ensure @-mentions trigger actual user notifications.
- Custom Field Mastery: Full support for setting and reading enum-based or numerical custom fields as first-class metadata.
- Dependency Mapping: Tools to interpret and manage task blockers and dependency graphs (dependents/dependencies).
- Attachment Handling: Support for both direct file uploads and embedding existing attachments as inline images.
SKILL.md
Loading
Related Openclaw Skills
My Life Feed
A powerful skill for managing My Life Feed tasks, groups, and invitations via a robust REST API integration.
Balance Checker
A unified utility to check remaining quotas and account balances across multiple AI API providers including DeepSeek and Moonshot.
hudy
A specialized MCP skill for querying Korean public holidays, calculating business days, and managing custom corporate schedules.
Stock Market Pro
A local-first market research toolkit for real-time quotes, technical indicator charts, and automated one-shot financial reports.
Asana
A dependency-free Node.js CLI skill for managing Asana tasks, projects, and custom fields using Personal Access Tokens.
Million Finney Homepage Pixel Guide
A comprehensive educational guide for agents to understand the technical process of claiming pixels and generating art on the Million Finney Homepage.
Featured*
