graph-search

Search Microsoft Teams messages via Microsoft Graph and extract matching conversation threads.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/Takas0522/ai-sldc-demo-takas-2603 --skill graph-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: graph-search
Source: https://github.com/Takas0522/ai-sldc-demo-takas-2603/tree/main/.github/skills/graph-search
Command: npx skills add https://github.com/Takas0522/ai-sldc-demo-takas-2603 --skill graph-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual effort of hunting through Microsoft Teams conversations by letting you locate relevant chat or channel messages and recover the surrounding thread context quickly.

Core Features & Use Cases

  • Keyword Search: Find Teams chat and channel messages by searching for terms, names, or topics across Microsoft Graph.
  • Thread Extraction: Reconstruct the full conversation around a matched message so you can review the complete discussion.
  • Fallback Coverage: Use a search-first workflow with a fallback path when broader Graph search is unavailable.
  • Use Case: A support or operations analyst can search for an incident keyword, inspect the matching message, and retrieve the full thread for summarization or follow-up.

Quick Start

Use this skill to search Microsoft Teams for a keyword and return the matching message thread with sender, timestamp, and conversation context.

Frequently Asked Questions about graph-search

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

FAQPage Schema
How do I search Microsoft Teams chat messages by keyword and extract the full thread?

Search Microsoft Teams chat messages by keyword and extract the full conversation thread using Microsoft Graph. This Skill locates matching messages across chats and channels and reconstructs the surrounding discussion context for compliance or support review.

What Microsoft Graph permissions do I need to read Teams channel messages?

Reading Teams channel messages through Microsoft Graph requires the Chat.Read permission, and ChannelMessage.Read.All is needed specifically for channel search. Microsoft Entra authentication via Device Code Flow is used to authorize access.

Do I need dotnet-script and .NET 10 to search Teams conversations through Microsoft Graph?

Yes, dotnet-script and .NET 10 are required to run this Teams conversation search. The Skill uses these dependencies to execute Microsoft Graph queries and reconstruct matching chat threads after authenticating with Microsoft Entra.

Can I retrieve Teams chat history for compliance and knowledge retrieval?

Yes, you can retrieve Teams chat history for compliance and knowledge retrieval. The Skill searches Microsoft Graph for incident keywords, inspects matching messages, and reconstructs the full thread context for summarization or follow-up actions.

What happens when broader Microsoft Graph search is unavailable for Teams messages?

When broader Microsoft Graph search is unavailable for Teams messages, the Skill uses a fallback path. This search-first workflow ensures you can still locate relevant chat or channel messages and recover the surrounding thread context.

Why does my Teams channel search fail with a Microsoft Graph permissions error?

A Teams channel search fails with a Microsoft Graph permissions error when ChannelMessage.Read.All is missing. You must authenticate via Microsoft Entra Device Code Flow and grant both Chat.Read and ChannelMessage.Read.All permissions to extract channel threads.