From a110a393329adb0e2cb9e0280e19ea7e67f6b342 Mon Sep 17 00:00:00 2001 From: shailendrahegde Date: Mon, 6 Apr 2026 16:22:06 -0700 Subject: [PATCH 1/3] =?UTF-8?q?Add=20whatidid=20skill=20=E2=80=94=20Copilo?= =?UTF-8?q?t=20impact=20report=20generator?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/README.skills.md | 1 + skills/whatidid/SKILL.md | 47 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 48 insertions(+) create mode 100644 skills/whatidid/SKILL.md diff --git a/docs/README.skills.md b/docs/README.skills.md index e3fd29872..7589b0518 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -292,6 +292,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [web-design-reviewer](../skills/web-design-reviewer/SKILL.md) | This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level. | `references/framework-fixes.md`
`references/visual-checklist.md` | | [webapp-testing](../skills/webapp-testing/SKILL.md) | Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. | `assets/test-helper.js` | | [what-context-needed](../skills/what-context-needed/SKILL.md) | Ask Copilot what files it needs to see before answering a question | None | +| [whatidid](../skills/whatidid/SKILL.md) | Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session. | None | | [winapp-cli](../skills/winapp-cli/SKILL.md) | Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, publish to the Microsoft Store, create external catalogs, or access Windows SDK build tools. Supports .NET (csproj), C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows. | None | | [winmd-api-search](../skills/winmd-api-search/SKILL.md) | Find and explore Windows desktop APIs. Use when building features that need platform capabilities — camera, file access, notifications, UI controls, AI/ML, sensors, networking, etc. Discovers the right API for a task and retrieves full type details (methods, properties, events, enumeration values). | `LICENSE.txt`
`scripts/Invoke-WinMdQuery.ps1`
`scripts/Update-WinMdCache.ps1`
`scripts/cache-generator` | | [winui3-migration-guide](../skills/winui3-migration-guide/SKILL.md) | UWP-to-WinUI 3 migration reference. Maps legacy UWP APIs to correct Windows App SDK equivalents with before/after code snippets. Covers namespace changes, threading (CoreDispatcher to DispatcherQueue), windowing (CoreWindow to AppWindow), dialogs, pickers, sharing, printing, background tasks, and the most common Copilot code generation mistakes. | None | diff --git a/skills/whatidid/SKILL.md b/skills/whatidid/SKILL.md new file mode 100644 index 000000000..61850f40c --- /dev/null +++ b/skills/whatidid/SKILL.md @@ -0,0 +1,47 @@ +--- +name: whatidid +description: "Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session." +--- + +# What I Did (Copilot) — Impact Report Generator + +Generate a professional impact report from your GitHub Copilot session logs. Shows what you accomplished, quantifies the human-equivalent effort, and presents it in a branded HTML report you can share with your manager or team. + +## What It Does + +- **Harvests** session data from `~/.copilot/session-state/` (local, private) +- **Analyses** each day's work using an AI prompt calibrated against peer-reviewed research +- **Generates** a self-contained HTML report with: + - Goals accomplished with task-level detail + - Human effort equivalent (research-grounded estimation) + - Skills augmented and collaboration patterns + - Estimation evidence with transparent methodology +- **Emails** the report via Outlook (optional) + +## Quick Start + +```bash +# Clone the repo +git clone https://github.com/microsoft/What-I-Did-Copilot.git +cd What-I-Did-Copilot + +# Generate a 7-day report +python whatidid.py --date 7D + +# Generate and email a 30-day report +python whatidid.py --date 30D --email +``` + +## Requirements + +- Python 3.10+ +- GitHub CLI (`gh auth login`) for AI analysis +- Active Copilot CLI or VS Code agent sessions + +## Privacy + +Your data stays on your machine. No telemetry, no cloud uploads. The AI analysis uses your own GitHub Models API token. No one has access to your report unless you share it. + +## Research Basis + +Effort estimates are grounded in 13 peer-reviewed sources including Alaswad et al. 2026, Cambon et al. 2023 (Microsoft Research), and the SPACE framework. See [full methodology](https://github.com/microsoft/What-I-Did-Copilot/blob/main/docs/effort-estimation-methodology.md). From d8e5a0ba77e1f715abd60e3900e3545afab05ab1 Mon Sep 17 00:00:00 2001 From: shailendrahegde Date: Mon, 6 Apr 2026 16:30:22 -0700 Subject: [PATCH 2/3] Fix: use single quotes for description in SKILL.md frontmatter Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- skills/whatidid/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/whatidid/SKILL.md b/skills/whatidid/SKILL.md index 61850f40c..db9553f5a 100644 --- a/skills/whatidid/SKILL.md +++ b/skills/whatidid/SKILL.md @@ -1,6 +1,6 @@ --- name: whatidid -description: "Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session." +description: 'Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session.' --- # What I Did (Copilot) — Impact Report Generator From f140f0ef74742b0a2e2e8f7f74d0a51f05762b24 Mon Sep 17 00:00:00 2001 From: shailendrahegde Date: Fri, 10 Apr 2026 07:11:29 -0700 Subject: [PATCH 3/3] Convert from skill to external plugin per reviewer feedback Address @aaronpowell's review: convert whatidid from a bundled skill to an external plugin referencing microsoft/What-I-Did-Copilot. This improves supply chain transparency and stays current with the source repo. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .github/plugin/marketplace.json | 25 ++++++++++++++++++ docs/README.skills.md | 1 - plugins/external.json | 17 ++++++++++++ skills/whatidid/SKILL.md | 47 --------------------------------- 4 files changed, 42 insertions(+), 48 deletions(-) delete mode 100644 skills/whatidid/SKILL.md diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json index 3f20d0349..eda9094ea 100644 --- a/.github/plugin/marketplace.json +++ b/.github/plugin/marketplace.json @@ -549,6 +549,31 @@ "description": "Comprehensive collection of prompts, instructions, and resources for building declarative agents and API plugins using TypeSpec for Microsoft 365 Copilot extensibility.", "version": "1.0.0" }, + { + "name": "whatidid", + "description": "Turn your Copilot sessions into proof of impact — research-grounded HTML reports with effort estimation, skills analysis, and ROI metrics from local session logs.", + "version": "1.0.0", + "author": { + "name": "Microsoft", + "url": "https://www.microsoft.com" + }, + "homepage": "https://github.com/microsoft/What-I-Did-Copilot", + "keywords": [ + "copilot", + "productivity", + "impact", + "report", + "estimation", + "roi", + "session-logs" + ], + "license": "MIT", + "repository": "https://github.com/microsoft/What-I-Did-Copilot", + "source": { + "source": "github", + "repo": "microsoft/What-I-Did-Copilot" + } + }, { "name": "winui3-development", "source": "winui3-development", diff --git a/docs/README.skills.md b/docs/README.skills.md index 7589b0518..e3fd29872 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -292,7 +292,6 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [web-design-reviewer](../skills/web-design-reviewer/SKILL.md) | This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers on requests like "review website design", "check the UI", "fix the layout", "find design problems". Detects issues with responsive design, accessibility, visual consistency, and layout breakage, then performs fixes at the source code level. | `references/framework-fixes.md`
`references/visual-checklist.md` | | [webapp-testing](../skills/webapp-testing/SKILL.md) | Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs. | `assets/test-helper.js` | | [what-context-needed](../skills/what-context-needed/SKILL.md) | Ask Copilot what files it needs to see before answering a question | None | -| [whatidid](../skills/whatidid/SKILL.md) | Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session. | None | | [winapp-cli](../skills/winapp-cli/SKILL.md) | Windows App Development CLI (winapp) for building, packaging, and deploying Windows applications. Use when asked to initialize Windows app projects, create MSIX packages, generate AppxManifest.xml, manage development certificates, add package identity for debugging, sign packages, publish to the Microsoft Store, create external catalogs, or access Windows SDK build tools. Supports .NET (csproj), C++, Electron, Rust, Tauri, and cross-platform frameworks targeting Windows. | None | | [winmd-api-search](../skills/winmd-api-search/SKILL.md) | Find and explore Windows desktop APIs. Use when building features that need platform capabilities — camera, file access, notifications, UI controls, AI/ML, sensors, networking, etc. Discovers the right API for a task and retrieves full type details (methods, properties, events, enumeration values). | `LICENSE.txt`
`scripts/Invoke-WinMdQuery.ps1`
`scripts/Update-WinMdCache.ps1`
`scripts/cache-generator` | | [winui3-migration-guide](../skills/winui3-migration-guide/SKILL.md) | UWP-to-WinUI 3 migration reference. Maps legacy UWP APIs to correct Windows App SDK equivalents with before/after code snippets. Covers namespace changes, threading (CoreDispatcher to DispatcherQueue), windowing (CoreWindow to AppWindow), dialogs, pickers, sharing, printing, background tasks, and the most common Copilot code generation mistakes. | None | diff --git a/plugins/external.json b/plugins/external.json index 08afb1447..830437c15 100644 --- a/plugins/external.json +++ b/plugins/external.json @@ -138,5 +138,22 @@ "source": "github", "repo": "figma/mcp-server-guide" } + }, + { + "name": "whatidid", + "description": "Turn your Copilot sessions into proof of impact — research-grounded HTML reports with effort estimation, skills analysis, and ROI metrics from local session logs.", + "version": "1.0.0", + "author": { + "name": "Microsoft", + "url": "https://www.microsoft.com" + }, + "homepage": "https://github.com/microsoft/What-I-Did-Copilot", + "keywords": ["copilot", "productivity", "impact", "report", "estimation", "roi", "session-logs"], + "license": "MIT", + "repository": "https://github.com/microsoft/What-I-Did-Copilot", + "source": { + "source": "github", + "repo": "microsoft/What-I-Did-Copilot" + } } ] diff --git a/skills/whatidid/SKILL.md b/skills/whatidid/SKILL.md deleted file mode 100644 index db9553f5a..000000000 --- a/skills/whatidid/SKILL.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -name: whatidid -description: 'Generate a branded HTML impact report showing what GitHub Copilot helped you accomplish — goals delivered, human effort equivalent, skills augmented, collaboration patterns, and estimation evidence grounded in peer-reviewed research. Works with any Copilot CLI or VS Code agent session.' ---- - -# What I Did (Copilot) — Impact Report Generator - -Generate a professional impact report from your GitHub Copilot session logs. Shows what you accomplished, quantifies the human-equivalent effort, and presents it in a branded HTML report you can share with your manager or team. - -## What It Does - -- **Harvests** session data from `~/.copilot/session-state/` (local, private) -- **Analyses** each day's work using an AI prompt calibrated against peer-reviewed research -- **Generates** a self-contained HTML report with: - - Goals accomplished with task-level detail - - Human effort equivalent (research-grounded estimation) - - Skills augmented and collaboration patterns - - Estimation evidence with transparent methodology -- **Emails** the report via Outlook (optional) - -## Quick Start - -```bash -# Clone the repo -git clone https://github.com/microsoft/What-I-Did-Copilot.git -cd What-I-Did-Copilot - -# Generate a 7-day report -python whatidid.py --date 7D - -# Generate and email a 30-day report -python whatidid.py --date 30D --email -``` - -## Requirements - -- Python 3.10+ -- GitHub CLI (`gh auth login`) for AI analysis -- Active Copilot CLI or VS Code agent sessions - -## Privacy - -Your data stays on your machine. No telemetry, no cloud uploads. The AI analysis uses your own GitHub Models API token. No one has access to your report unless you share it. - -## Research Basis - -Effort estimates are grounded in 13 peer-reviewed sources including Alaswad et al. 2026, Cambon et al. 2023 (Microsoft Research), and the SPACE framework. See [full methodology](https://github.com/microsoft/What-I-Did-Copilot/blob/main/docs/effort-estimation-methodology.md).