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..a2c9eab --- /dev/null +++ b/plugins/workiq/README.md @@ -0,0 +1,40 @@ +# WorkIQ + +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: + +| 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 + +### `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`](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 + +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. + +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).