ava-mcp-usage

Guide for using Ava's MCP tools effectively for task management and progress reporting. Use when working with Ava MCP server to report progress on coding tasks, including starting tasks, updating progress, reporting blockers, and completing tasks. Helps users understand best practices for privacy-conscious task reporting with minimal effort.

⭐9stars🔀1forks📁View on GitHub🕐Updated Dec 13, 2025

When & Why to Use This Skill

This Claude skill optimizes developer workflows by automating task management and progress reporting through Ava's MCP tools. It facilitates proactive communication by sending privacy-conscious updates to Slack, ensuring team alignment on coding milestones, blockers, and task completion with minimal manual effort.

Use Cases

  • Automated Task Tracking: Seamlessly initiate and track coding tasks in Slack to maintain a transparent and organized record of work-in-progress.
  • Proactive Milestone Updates: Automatically report granular progress after completing technical steps like schema changes, API implementations, or refactoring without needing manual prompts.
  • Efficient Blocker Resolution: Instantly notify the team of technical hurdles or environment issues via Slack to seek help early and reduce project downtime.
  • Privacy-Conscious Reporting: Share high-level work summaries and PR links with stakeholders while ensuring sensitive code and secrets remain private.
nameava-mcp-usage
descriptionGuide for using Ava's MCP tools effectively for task management and progress reporting. Use when working with Ava MCP server to report progress on coding tasks, including starting tasks, updating progress, reporting blockers, and completing tasks. Helps users understand best practices for privacy-conscious task reporting with minimal effort.

Ava MCP Usage

Overview

Ava provides MCP tools for automatic progress reporting to Slack. This skill shows you how to use these tools effectively with minimal mental burden while maintaining privacy.

Core Philosophy

Ava works best when you tell it what to watch: "Keep an eye on this work."

Important: Treat any coding work as a task, even if the user doesn't explicitly say "task". When the user starts working on something, that's a task to track.

Key principles:

  • Treat all coding work as tasks worth tracking
  • Report only the current task
  • Proactive, frequent updates: Report progress at every meaningful milestone without waiting for user prompts
  • Update granularly: schema changes, file edits, endpoint implementations, test additions - all worth reporting
  • Ask for help immediately when blocked
  • Ask user for consent before marking tasks complete
  • Short commands are sufficient
  • One task per session: If starting different work while a task is active, ask the user if they want to complete the current task first or start a new Claude Code session for the new work

MCP Tools Quick Reference

start_task

Tell Ava what you're working on now. Treat any coding work as a task, even if not explicitly called a "task".

Start task: ログインのエラー処理改善

Tips:

  • Treat all coding work as tasks worth tracking
  • Only report the task you're currently working on
  • Be specific but concise
  • Ava will create a Slack thread for this task
  • Before starting a new task: If there's already an active task in this session, ask the user: "Should I complete the current task first, or would you like to start a new Claude Code session for this different work?"

update_task

Report progress proactively at every meaningful milestone, even without user prompts.

Update task: リトライ実装が完了

When to update (proactively):

  • After creating or editing a schema file
  • After implementing an endpoint or API route
  • After adding validation logic
  • After writing tests
  • After fixing a bug or error
  • After refactoring a component
  • Any other meaningful progress point

Tips:

  • Don't wait for user prompts - update proactively when you complete a milestone
  • Small, granular updates are highly valuable - they create a clear activity trail
  • No need for detailed explanations - brief summaries are sufficient
  • Each update goes to the same Slack thread

report_blocked

Share blockers without hesitation.

Report blocked: テスト環境でトークンが通らない

Tips:

  • Don't hold back - reporting early helps
  • Brief descriptions are fine
  • Ava notifies your team in the Slack thread

complete_task

Mark completion after confirming with the user.

Complete task: レビュー完了してマージしました

Tips:

  • PR creation is progress, not completion
  • Always ask the user before marking a task complete
  • Include PR URL if relevant

Privacy-Conscious Reporting

Ava sends only abstract summaries to Slack/MCP. Never send code or secrets.

❌ Do NOT send:

  • Full code
  • Secret keys or tokens
  • Detailed error logs
  • Repository confidential information

✅ Safe to send:

  • Abstract work summaries
  • Brief blocker descriptions
  • Completion summary with PR URL

Remember: Your code and judgment stay private. Ava only delivers progress updates.

Minimal Effort Required

Ava and your coding agent work together to fill in details. Short phrases are enough:

Start task: fix auth bug
Update task: retry logic done
Report blocked: test token issue
Complete task: merged

No need for elaborate explanations - Ava understands context and supplements your brief inputs.