From 9b7eea1c66b64d58f8104596018a44fc15ad128d Mon Sep 17 00:00:00 2001 From: Jason Etcovitch Date: Mon, 16 Mar 2026 12:19:55 -0400 Subject: [PATCH 1/2] Add READMEs for spark and workiq plugins Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- plugins/spark/README.md | 33 +++++++++++++++++++++++++++++++++ plugins/workiq/README.md | 27 +++++++++++++++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 plugins/spark/README.md create mode 100644 plugins/workiq/README.md diff --git a/plugins/spark/README.md b/plugins/spark/README.md new file mode 100644 index 0000000..ce9581d --- /dev/null +++ b/plugins/spark/README.md @@ -0,0 +1,33 @@ +# Spark + +Comprehensive guidance for building modern web applications with opinionated defaults for tech stack, design system, and code standards. + +## What it does + +Spark helps you quickly bootstrap high-quality web applications by providing: + +- Pre-vetted technology stack choices with multiple complexity-based variations +- An opinionated design philosophy and system +- Step-by-step setup workflows +- Design and performance optimization guidance + +## Skills + +### `spark-app-template` + +Activated when a user wants to create a new web application, dashboard, or interactive interface. Provides guidance on: + +- **Tech stack** — Vite, React 19+, TypeScript, Tailwind CSS v4+, shadcn/ui, TanStack Router & Query +- **Design system** — Typography pairings, OKLCH color palettes, spatial composition, micro-interactions +- **Stack variations** — Pre-configured stacks tailored to app complexity (default web app, content showcase, data dashboard, complex application) +- **Performance** — Core Web Vitals targets, React Compiler setup, optimization checklists +- **Component patterns** — Common shadcn compositions and usage patterns + +## Stack variations + +| Stack | Use case | +| --- | --- | +| **Default Web App** | General-purpose tools, utilities, simple CRUD, MVPs, prototypes | +| **Content Showcase** | Marketing sites, portfolios, blogs, documentation | +| **Data Dashboard** | Analytics dashboards, admin panels, BI tools, monitoring | +| **Complex Application** | SaaS platforms, enterprise tools, multi-view apps | diff --git a/plugins/workiq/README.md b/plugins/workiq/README.md new file mode 100644 index 0000000..d0d4438 --- /dev/null +++ b/plugins/workiq/README.md @@ -0,0 +1,27 @@ +# WorkIQ + +Workplace intelligence plugin that connects AI agents to Microsoft 365 Copilot, providing access to organizational data from Outlook, Teams, SharePoint, OneDrive, and Calendar. + +## What it does + +WorkIQ grounds AI assistance in real workplace context by querying Microsoft 365 data sources. It enables agents to answer questions about: + +- **Emails & messages** — Find and summarize email threads and Teams conversations +- **Meetings** — Retrieve decisions, action items, and context from calendar events +- **Documents** — Locate specs, design docs, and files across SharePoint and OneDrive +- **People** — Identify subject-matter experts, project owners, and organizational relationships +- **Priorities** — Surface what colleagues are focused on, team goals, and project status + +## Skills + +### `workiq` + +Activated when a user asks about workplace context — what someone said, meeting outcomes, document locations, team priorities, or organizational knowledge. Uses the `ask_work_iq` MCP tool to query Microsoft 365 Copilot with natural language questions. + +## MCP server + +WorkIQ includes an MCP server configuration (`.mcp.json`) that runs the `@microsoft/workiq` package. Authentication is automatic using the connected user's existing Microsoft 365 credentials. + +## Requirements + +- Microsoft 365 account with Copilot access From 70f391a20aa3a9819a87020cb28d53dab9791f8b Mon Sep 17 00:00:00 2001 From: Jason Etcovitch Date: Mon, 16 Mar 2026 12:23:52 -0400 Subject: [PATCH 2/2] Enrich WorkIQ README with upstream package context Add data type query examples, prerequisites, admin consent info, and link to the @microsoft/workiq MCP server package. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- plugins/workiq/README.md | 29 +++++++++++++++++++++-------- 1 file changed, 21 insertions(+), 8 deletions(-) diff --git a/plugins/workiq/README.md b/plugins/workiq/README.md index d0d4438..a2c9eab 100644 --- a/plugins/workiq/README.md +++ b/plugins/workiq/README.md @@ -2,15 +2,21 @@ Workplace intelligence plugin that connects AI agents to Microsoft 365 Copilot, providing access to organizational data from Outlook, Teams, SharePoint, OneDrive, and Calendar. +Powered by the [`@microsoft/workiq`](https://github.com/microsoft/work-iq-mcp) MCP server. + +> ⚠️ **Public Preview:** Features and APIs may change. + ## What it does WorkIQ grounds AI assistance in real workplace context by querying Microsoft 365 data sources. It enables agents to answer questions about: -- **Emails & messages** — Find and summarize email threads and Teams conversations -- **Meetings** — Retrieve decisions, action items, and context from calendar events -- **Documents** — Locate specs, design docs, and files across SharePoint and OneDrive -- **People** — Identify subject-matter experts, project owners, and organizational relationships -- **Priorities** — Surface what colleagues are focused on, team goals, and project status +| Data type | Example questions | +| --- | --- | +| **Emails** | "What did John say about the proposal?" | +| **Meetings** | "What's on my calendar tomorrow?" | +| **Documents** | "Find my recent PowerPoint presentations" | +| **Teams** | "Summarize today's messages in the Engineering channel" | +| **People** | "Who is working on Project Alpha?" | ## Skills @@ -20,8 +26,15 @@ Activated when a user asks about workplace context — what someone said, meetin ## MCP server -WorkIQ includes an MCP server configuration (`.mcp.json`) that runs the `@microsoft/workiq` package. Authentication is automatic using the connected user's existing Microsoft 365 credentials. +WorkIQ includes an MCP server configuration (`.mcp.json`) that runs the [`@microsoft/workiq`](https://www.npmjs.com/package/@microsoft/workiq) package. Authentication is automatic using the connected user's existing Microsoft 365 credentials. + +## Prerequisites + +- **Node.js 18+** — [Download from nodejs.org](https://nodejs.org/) +- **Microsoft 365 account** with Copilot access + +## Admin consent -## Requirements +To access Microsoft 365 tenant data, the WorkIQ MCP server needs permissions that require administrative rights on the tenant. On first access, a consent dialog appears. If you are not an administrator, contact your tenant administrator to grant access. -- Microsoft 365 account with Copilot access +For more information, see Microsoft's [User and Admin Consent Overview](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/user-admin-consent-overview).