workiq_skill

Overview

This skill lets you query your Microsoft 365 data from the command line using the WorkIQ CLI. It answers natural-language questions about emails, calendar events, documents, Teams messages, and people/org insights. The skill only returns data the signed-in user already has permission to access.

How this skill works

You run the WorkIQ CLI (prefer the global workiq binary or npx fallback) and pass a natural-language question; WorkIQ queries Microsoft 365 data sources the authenticated user can see. Each call is stateless, so follow-up questions must include full context. Authentication, EULA acceptance, and any tenant-specific flags are handled by the CLI.

When to use it

• Find or summarize recent emails about a topic
• Check upcoming meetings or who attended a past meeting
• Locate and summarize documents or specs
• Summarize messages in a Teams channel for a given day
• Lookup people or org info such as project owners or managers
• Extract issues or notes from a recent meeting

Best practices

• Ask in natural language and be specific—include names, project names, channels, or dates
• Include the full context for follow-ups because each CLI call is stateless
• Run the CLI standalone; do not pipe or combine WorkIQ output with other shell commands
• If running for the first time, accept the EULA with workiq accept-eula before querying
• When signing in, run workiq ask interactively to complete the authentication flow

Example use cases

• Summarize emails from Sarah about the budget last week: workiq ask -q "Summarize emails from Sarah about the budget last week"
• What meetings do I have tomorrow?: workiq ask -q "What meetings do I have tomorrow?"
• Find recent documents about Q4 planning: workiq ask -q "Find my recent documents about Q4 planning"
• Summarize today’s messages in the Engineering channel: workiq ask -q "Summarize today's messages in the Engineering channel"
• Who is working on Project Alpha?: workiq ask -q "Who is working on Project Alpha?"