# asana

> Interface for Asana project management using asana-cli. Use this skill when users want to find tasks, update tickets, create new tasks, list projects, check task status, search for work, manage dependencies, or perform any Asana-related work management operations. (project, gitignored)

- Author: James Felix Black
- Repository: tftio/claude-skills
- Version: 20260130135044
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/tftio/claude-skills
- Web: https://mule.run/skillshub/@@tftio/claude-skills~asana:20260130135044

---

---
name: asana
description: Interface for Asana project management using asana-cli. Use this skill when users want to find tasks, update tickets, create new tasks, list projects, check task status, search for work, manage dependencies, or perform any Asana-related work management operations. (project, gitignored)
tools: Bash, Read, Glob
metadata:
  version: 1.0.0
  tags: [project-management, asana, cli-wrapper]
---

# Asana Skill

Interface for interacting with Asana through the `asana-cli` command-line tool.

## Tool Location

**Binary:** `$HOME/.local/bin/asana-cli`

```bash
# Verify installation
$HOME/.local/bin/asana-cli --version
$HOME/.local/bin/asana-cli doctor
```

## Resource Files

Detailed references are in `resources/`:

- **commands.md**: Full command syntax for tasks, projects, sections, tags
- **workflows.md**: Work tracking integration, common workflows, best practices

## Output Formats

All list/show commands support `--output`:

- `table` - Human-readable (default)
- `json` - For scripting (RECOMMENDED)
- `csv` - Spreadsheet export
- `markdown` - Documentation

## Quick Reference

### Tasks

```bash
# List tasks
$HOME/.local/bin/asana-cli task list --project "GID" --completed false --output json

# Search tasks
$HOME/.local/bin/asana-cli task search --workspace "GID" --query "keyword"

# Create task
$HOME/.local/bin/asana-cli task create --name "Task" --workspace "GID" --project "GID" --assignee "email"

# Update task
$HOME/.local/bin/asana-cli task update "TASK_GID" --complete
$HOME/.local/bin/asana-cli task update "TASK_GID" --assignee "email" --due-on "next Friday"

# Add comment
$HOME/.local/bin/asana-cli task comments add "TASK_GID" --text "Comment text"
```

### Projects

```bash
# List projects
$HOME/.local/bin/asana-cli project list --workspace "GID" --archived false

# Create project
$HOME/.local/bin/asana-cli project create --name "Project" --workspace "GID"

# List sections
$HOME/.local/bin/asana-cli section list --project "GID"
```

### Work Tracking

**See `resources/workflows.md` for complete integration details.**

```bash
# Check for work context
if [ -f .work-metadata.toml ]; then
  TASK_ID=$(toml get .work-metadata.toml work.asana_task | grep -oE '[0-9]+$')
fi

# Load standards
prompter workflow.issue-tracking
```

**Update at checkpoints only:**
1. Work start - Status to "In Progress"
2. GitHub issues created - Add comment with links
3. PRs opened - Add comment with PR links
4. Work complete - Mark complete with summary

## Configuration

```bash
# Set token
$HOME/.local/bin/asana-cli config set token

# Test auth
$HOME/.local/bin/asana-cli config test

# Set defaults
$HOME/.local/bin/asana-cli config set workspace --workspace "GID"
$HOME/.local/bin/asana-cli config set assignee --assignee "email"
```

## Troubleshooting

```bash
# Check health
$HOME/.local/bin/asana-cli doctor

# Debug mode
RUST_LOG=debug $HOME/.local/bin/asana-cli task list
```

## Notes

- Natural language dates accepted: "tomorrow", "next Friday", "in 2 weeks"
- Use `--output json` for reliable parsing in scripts
- Batch operations available for bulk changes (see resources/commands.md)