Skip to content

Prepare the plugins for the Claude and OpenAI directories - #1291

Merged
Zach Teutsch (zateutsch) merged 10 commits into
mainfrom
niels9001/plugin-directory-prep
Nov 15, 2026
Merged

Zach Teutsch (zateutsch) merged 10 commits into
mainfrom
niels9001/plugin-directory-prep

Conversation

@niels9001

@niels9001 Niels Laute (niels9001) commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

What and why

Two plugin directories would reject winui and winappcli as they are on main:

  • Claude: Anthropic's plugin directory refuses a plugin folder without a README of at least 40 words, and plugins/winui and plugins/winapp had 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.
  • OpenAI (Codex and ChatGPT): OpenAI's plugin directory allows short descriptions of at most 30 characters and at most 3 starter prompts. Both Codex manifests now fit. They also set 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:

Rule Before After
Claude: README in the plugin folder, 40+ words none in plugins/winui or plugins/winapp (blocks submission) 384 and 513 words
OpenAI: short description, 30 characters or fewer winui 46, winappcli 72 "Build and ship WinUI 3 apps" (27), "Package and sign Windows apps" (29)
OpenAI: at most 3 starter prompts winui 4, winappcli 3 3 each
OpenAI: skills-only plugin that runs local programs sets requires_local_executor not set true in both

Checked locally:

  • claude plugin validate --strict .\plugins\winui and .\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 CLI 0.164.0 with an empty CODEX_HOME: codex plugin marketplace add with this checkout's path, then codex plugin add winui@winappcli and codex plugin add winappcli@winappcli, installed and enabled both. The installed manifests keep requires_local_executor.

Not tested / risks

  • I couldn't run Anthropic's Validate step or OpenAI's upload checks, because both need the accounts that will submit. These changes follow their published rules.
  • OpenAI may refuse requires_local_executor from 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.
  • The READMEs list what WinApp CLI downloads and sends today. They need an update if that changes.

Checklist

  • Tested locally on Windows
  • Docs, samples, and plugins/winapp/skills/ updated if user-facing behavior changed
Notes for reviewers
  • Dropped starter prompt: "Build and run the WinUI 3 project in this folder and fix any errors." Create, migrate, and package are the three most distinct starting points; swap one if you prefer.
  • Each README claim is checked against the skills and the CLI source: 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 for winapp sign).
  • requires_local_executor sits 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.
  • OpenAI needs a new ZIP upload for each release. I haven't tested whether the plugin folders upload as they are; [Feature]: Point the public winui and winappcli plugin listings at this repo's releases #1260 tracks that.

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
Copilot AI balanced review requested due to automatic review settings November 5, 2026 09:55
@niels9001 Niels Laute (niels9001) added the agent-preparing Agent is addressing feedback or completing required validation and CI label Nov 5, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 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

Comment thread plugins/winapp/README.md Resolved
Comment thread plugins/winapp/README.md Resolved
@github-actions

github-actions Bot commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Build Metrics Report

Validation passed. All required build and validation jobs succeeded.

Binary Sizes

Artifact Baseline Current Delta
CLI (ARM64) 65.65 MB 65.65 MB ✅ 0.0 KB (0.00%)
CLI (x64) 65.46 MB 65.46 MB ✅ 0.0 KB (0.00%)
MSIX (ARM64) 27.14 MB 27.14 MB 📈 +0.4 KB (+0.00%)
MSIX (x64) 28.76 MB 28.76 MB 📈 +0.5 KB (+0.00%)
NPM Package 56.53 MB 56.53 MB 📈 +0.3 KB (+0.00%)
NuGet Package 56.69 MB 56.69 MB 📉 -0.3 KB (-0.00%)

.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 Time

53ms median (x64, winapp --version) · 📉 -23ms vs. baseline

Try This Build

Installs 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))) 1291
Switching between builds often?

Put the tool on your PATH once:

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/microsoft/winappCli/main/scripts/winapp-pr.ps1))) -AddToPath

Then this build is just:

winapp-pr 1291

Run winapp-pr with no arguments to pick from a list of open PRs.


Updated 2026-11-12 22:15:39 UTC · commit 2631958 · workflow run

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
@niels9001 Niels Laute (niels9001) added ready-for-review Agent work and technical checks complete; awaiting review or re-review, not approval or merge and removed agent-preparing Agent is addressing feedback or completing required validation and CI labels Nov 5, 2026
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: ccdd38eb-cec9-4430-98cd-6cbb6cc4bd63
@niels9001 Niels Laute (niels9001) added agent-preparing Agent is addressing feedback or completing required validation and CI ready-for-review Agent work and technical checks complete; awaiting review or re-review, not approval or merge and removed ready-for-review Agent work and technical checks complete; awaiting review or re-review, not approval or merge agent-preparing Agent is addressing feedback or completing required validation and CI labels Nov 8, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

No winapp skill runs icacls, so the README shouldn't list it.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@zateutsch
Zach Teutsch (zateutsch) merged commit 92290ff into main Nov 15, 2026
3 checks passed
@zateutsch
Zach Teutsch (zateutsch) deleted the niels9001/plugin-directory-prep branch November 15, 2026 22:47
@niels9001 Niels Laute (niels9001) removed the ready-for-review Agent work and technical checks complete; awaiting review or re-review, not approval or merge label Nov 16, 2026
Nikola Metulev (nmetulev) pushed a commit that referenced this pull request Nov 16, 2026
## 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants