Repository navigation
Prepare the plugins for the Claude and OpenAI directories - #1291
Conversation
Anthropic's plugin directory refuses a plugin folder without a README of at least 40 words, and plugins/winui and plugins/winapp had none. Add one to each that says what the plugin does and what it runs, downloads, and sends on the user's computer, which Anthropic's reviewers check. OpenAI's plugin directory allows short descriptions of at most 30 characters and at most 3 starter prompts. Shorten both Codex short descriptions, drop winui's fourth prompt, and set requires_local_executor so the listing shows Desktop only, because the skills run programs locally. Codex 0.164.0 still installs both plugins. Part of #1260 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63
There was a problem hiding this comment.
🟡 Changes recommended
The README’s data-sharing disclosure still omits app-package uploads to Microsoft Store and Microsoft’s timestamp service used by Azure signing.
2 open issues
What changed in this PR
Prepares the WinUI and WinApp CLI plugins for submission to the Claude and OpenAI directories as part of #1260. Installation through this repo’s marketplaces stays unchanged.
Changes:
- Adds plugin READMEs covering capabilities, installation, local commands, downloads, and data sharing.
- Shortens both Codex listing descriptions and reduces WinUI’s starter prompts to three.
- Marks both Codex plugins as requiring local execution for desktop-only listings.
| File | Description |
|---|---|
plugins/winui/README.md |
Introduces WinUI workflows and documents local activity and data sharing. |
plugins/winui/.codex-plugin/plugin.json |
Adjusts listing text, limits starter prompts, and requires local execution. |
plugins/winapp/README.md |
Introduces WinApp CLI workflows and documents local activity and data sharing. |
plugins/winapp/.codex-plugin/plugin.json |
Shortens the listing description and requires local execution. |
Review effort: Balanced
Build Metrics ReportValidation passed. All required build and validation jobs succeeded. Binary Sizes
.NET Test Results (TRX reports)Other suites are reflected in the overall validation status above. ✅ 11048 passed, 44 skipped out of 11092 tests in 2012.1s (+128.2s vs. baseline) Test Coverage✅ 87.6% line coverage, 81.7% branch coverage · ✅ no change vs. baseline CLI Startup Time53ms median (x64, Try This BuildInstalls the MSIX for your architecture, replacing any previously installed build. Needs the GitHub CLI — the command offers to install it and sign you in if it is missing. & ([scriptblock]::Create((irm https://raw.githubusercontent.com/microsoft/winappCli/main/scripts/winapp-pr.ps1))) 1291Switching between builds often?Put the tool on your PATH once: & ([scriptblock]::Create((irm https://raw.githubusercontent.com/microsoft/winappCli/main/scripts/winapp-pr.ps1))) -AddToPathThen this build is just: winapp-pr 1291Run Updated 2026-11-12 22:15:39 UTC · commit |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63
Azure Trusted Signing always timestamps with Microsoft's server, not DigiCert's, and submitting with winapp store uploads the app package to Partner Center. Add both to the list of what WinApp CLI sends. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63
Jaylyn Barbee (Jaylyn-Barbee)
left a comment
There was a problem hiding this comment.
LGTM
No winapp skill runs icacls, so the README shouldn't list it. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
## What and why The winappcli plugin README lists the programs its skills have your agent run on your computer. Claude's plugin directory asks plugins to disclose this. #1291 removed `icacls` from that list, but the `winapp-sandbox` skill still uses it: when Windows Sandbox can't open a project folder (`sandbox_transport_failed`, `0x80070005`), the agent runs the `icacls` command from winapp's error message to give Sandbox access to that folder, then retries. This puts `icacls` back on the list. ## Before / after **Before:** PowerShell to install or remove app packages, and Windows Sandbox tools (`wsb`, `dism`). **After:** PowerShell to install or remove app packages, and Windows Sandbox tools (`wsb`, `dism`, `icacls`). ## Not tested / risks None. This changes one line of README text. <details><summary>Notes for reviewers</summary> The skill step is in [`winapp-sandbox/SKILL.md`](https://github.com/microsoft/winappCli/blob/206503d22344a19f9c62391e91646666b3d0189c/plugins/winapp/skills/winapp-sandbox/SKILL.md#L180-L181) ("Folder share refused"). winapp prints the `icacls` command in `WindowsSandboxCli.cs`. </details> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63

What and why
Two plugin directories would reject
winuiandwinappclias they are onmain:plugins/winuiandplugins/winapphad none. Each folder now has a README that says what the plugin does, and what it runs, downloads, and sends on the user's computer. Anthropic's reviewers check that last part.requires_local_executor, which marks the listing Desktop only, because the skills run programs on the user's computer.Installing from this repo's marketplaces doesn't change.
Part of #1260
Before / after
Measured against the published rules in Anthropic's pre-submission checklist and OpenAI's submission rules:
plugins/winuiorplugins/winapp(blocks submission)winui46,winappcli72winui4,winappcli3requires_local_executortruein bothChecked locally:
claude plugin validate --strict .\plugins\winuiand.\plugins\winapp(Claude Code 2.1.258): passed..\scripts\validate-plugin-package.ps1: passed.node scripts/vally/lint-skills.mjs: 14 of 14 and 7 of 7 skills passed.Invoke-Pester .\scripts\tests\live-schema.Tests.ps1: 12 passed.CODEX_HOME:codex plugin marketplace addwith this checkout's path, thencodex plugin add winui@winappcliandcodex plugin add winappcli@winappcli, installed and enabled both. The installed manifests keeprequires_local_executor.Not tested / risks
requires_local_executorfrom an organization it hasn't approved for desktop-only plugins. Then an OpenAI representative has to confirm access, as OpenAI's desktop-only guide says.Checklist
plugins/winapp/skills/updated if user-facing behavior changedNotes for reviewers
SampleIndexFetcher.cs(catalogs from GitHub),UpdateNotificationService.cs(update check),MSStoreCLIService.cs(Store CLI),VcLibsPayloadAcquirer.cs(VC++ runtime for Sandbox runs),docs/debugging.md(crash diagnosis downloads),docs/telemetry.md,AzureSignToolService.cs(Microsoft's timestamp server for Azure Trusted Signing), and the signing skills (DigiCert's timestamp server forwinapp sign).requires_local_executorsits at the top level of.codex-plugin/plugin.json, where OpenAI documents it for that manifest format. Codex 0.164.0 ignores it, so local installs are unchanged.