Official agent skill

Channel Audit

by microsoft in microsoft/work-iq

Audit Teams channels across your teams — identify inactive channels, low‑engagement conversations, channels with no recent posts, and recommend cleanup actions.

OfficialCustom licenceAuto-check passed

Install Channel Audit

skills CLI
$ npx skills add microsoft/work-iq --skill channel-audit -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/work-iq channel-audit --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/work-iq.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/workiq-productivity/skills/channel-audit .claude/skills/channel-audit && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
channel-audit
GitHub stars
1k
Token cost
~2.5k tokens
SKILL.md length
953 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
Custom licence

At a glance

Audit Teams channels across your teams — identify inactive channels, low‑engagement conversations, channels with no recent posts, and recommend cleanup actions.

  • Works in 7 steps: Identify the User → Discover All Teams and Channels → Assess Channel Activity → …
  • SKILL.md covers When to Use, Instructions, Output Format and Parameters, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Channel Audit is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. Audit Teams channels across your teams — identify inactive channels, low‑engagement conversations, channels with no recent posts, and recommend cleanup actions.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Microsoft Teams. The repository describes itself as: MCP Server and CLI for accessing Work IQ.

Example prompts

  • “/channel-audit”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Identify the User
  2. Discover All Teams and Channels
  3. Assess Channel Activity
  4. Get Channel Membership Data
  5. Classify Channel Health
  6. Identify Potential Duplicates
  7. Compile the Audit Report

What it can do on your machine

Read from SKILL.md and the folder at commit 1060873. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Channel Audit loads about 2.5k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 953 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 953 words (~2,495 tokens).

“Audit all Microsoft Teams channels across your teams to assess activity levels and engagement health. Identifies inactive channels, stale conversations, and low‑engagement spaces — then presents a prioritized audit report with recommended cleanup actions such as archiving, merging, or reviving…”

— opening of SKILL.md by microsoft, Custom licence
name
channel-audit

Read the full SKILL.md on GitHub

Files

Just SKILL.md in plugins/workiq-productivity/skills/channel-audit of microsoft/work-iq.

Open the folder on GitHubat commit 1060873

Compare with similar skills

Channel Audit next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Channel Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Channel Audit this skillmicrosoft/work-iq1k—~2.5kAutomated safety check: PassCustom licence
Teams Devmicrosoft/teams-sdk729—~1.2kAutomated safety check: PassMIT
Vexa MeetingsVexa-ai/vexa2.9k—~631Automated safety check: PassApache-2.0
Add Channel Setup Guidenovuhq/novu40k—~1.7kAutomated safety check: PassCustom licence
Spfx Releasepnp/docker-spfx134—~572Automated safety check: NotesMIT
Soul Interviewldbumble/taskuary137—~1.4kAutomated safety check: PassMIT

Similar skills

  • Teams Dev

    microsoft/teams-sdk

    Official

    A skill your agent uses whenever the user mentions Microsoft Teams in a development context — whether they're building, integrating, configuring, debugging, or just asking questions.

    729 GitHub stars~1.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Vexa Meetings

    Vexa-ai/vexa

    Sends a Vexa bot into a meeting, follows the live transcript and writes meeting notes with speakers, decisions and action items into Obsidian, Notion or Markdown.

    2.9k GitHub stars~631 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Add a new chat channel's layer-1 setup guide — the in-dashboard <ChannelSetupGuide that walks a developer through connecting the channel itself (create app/bot → save credentials → install/verify →…

    40k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Spfx Release

    pnp/docker-spfx

    Automate SPFx version releases - branch, update files, commit, open PR, then tag after merge

    134 GitHub stars~572 tokensUpdated 3 mo ago
    Documents & OfficeAuto-check: notes
  • Soul Interview

    ldbumble/taskuary

    Conduct a seven-question adaptive interview and turn the answers into Taskuary's SOUL.md.

    137 GitHub stars~1.4k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Add a new chat channel's layer-2 dashboard onboarding — the connected-state "What's next" / "FOR YOUR USERS" developer-rollout guide plus its connected details page — in apps/dashboard, following…

    40k GitHub stars~1.7k tokensUpdated today
    Backend & APIsAuto-check passed

More from microsoft/work-iq

All 18 skills in this repo
  • Official

    Create, build, deploy, and localize declarative agents for M365 Copilot and Teams.

    1k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • M365 Agent Evaluator

    microsoft/work-iq

    Official

    A skill your agent uses when a user wants to create, run, or analyze evaluation suites for Microsoft 365 Copilot declarative agents with the public @microsoft/m365-copilot-eval CLI.

    1k GitHub stars~2k tokensUpdated today
    Auto-check: notes
  • Install Atk

    microsoft/work-iq

    Official

    Install or update the M365 Agents Toolkit (ATK) CLI and VS Code extension.

    1k GitHub stars~668 tokensUpdated today
    Auto-check passed
  • Teams App Developer

    microsoft/work-iq

    Official

    Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI.

    1k GitHub stars~1.8k tokensUpdated today
    Auto-check: notes
  • UI Widget Developer

    microsoft/work-iq

    Official

    Build MCP servers for Copilot Chat using the OpenAI Apps SDK or MCP Apps SDK widget rendering support (any language).

    1k GitHub stars~6.1k tokensUpdated today
    Auto-check: notes
  • Workiq

    microsoft/work-iq

    Official

    WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

    1k GitHub stars~15k tokensUpdated today
    Auto-check passed

Works with

Questions about Channel Audit

What does Channel Audit do?

Audit Teams channels across your teams — identify inactive channels, low‑engagement conversations, channels with no recent posts, and recommend cleanup actions. Channel Audit is an agent skill from microsoft/work-iq, published by the product's own GitHub organization. Audit Teams channels across your teams — identify inactive channels, low‑engagement conversations, channels with no recent posts, and recommend cleanup actions.

How do I install Channel Audit in Claude Code?

Run `npx skills add microsoft/work-iq --skill channel-audit -a claude-code`. Or copy the skill folder (plugins/workiq-productivity/skills/channel-audit in microsoft/work-iq) into .claude/skills/channel-audit in your project. Claude Code loads it when a task matches its description.

How do I install Channel Audit in Codex?

Run `npx skills add microsoft/work-iq --skill channel-audit -a codex`. Or copy the skill folder (plugins/workiq-productivity/skills/channel-audit in microsoft/work-iq) into .agents/skills/channel-audit in your project. Codex loads it when a task matches its description.

Can I use Channel Audit in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/work-iq --skill channel-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/channel-audit, .gemini/skills/channel-audit, .github/skills/channel-audit and .opencode/skills/channel-audit in your project.

What does Channel Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: Channel Audit is instructions for the agent only.

Does Channel Audit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Channel Audit safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Channel Audit use?

Channel Audit has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Channel Audit use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Channel Audit?

Skills that share tags, products or a category with Channel Audit: Teams Dev (microsoft/teams-sdk, 729 stars), Vexa Meetings (Vexa-ai/vexa, 2.9k stars), Add Channel Setup Guide (novuhq/novu, 40k stars) and Spfx Release (pnp/docker-spfx, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Channel Audit?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/work-iq, which has 1,029 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 2026.

Source: microsoft/work-iq on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.