richfrem/agent-plugins-skills / plugins/agent-extension-authoring/.apm/skills/packaging-copilot-cowork-plugins
packaging-copilot-cowork-plugins
VerifiedCreates, validates and prepares Microsoft 365 Copilot Cowork plugin App Packages containing Agent Skills and optional remote MCP connectors. Use when scaffolding, converting, validating, provisioning, packaging or sharing a Cowork plugin. Not for APM package creation or installation (use packaging-with-apm).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.2 KB |
| evals/evals.json | config | 1.6 KB |
| evals/task-success.json | config | 3.1 KB |
| packaging-copilot-cowork-plugins-flow.mmd | other | 651 B |
| references/acceptance-criteria.md | markdown | 3.1 KB |
| references/cowork-capabilities-and-limits.md | markdown | 3.7 KB |
| references/cowork-deterministic-vs-generative.md | markdown | 3.5 KB |
| references/cowork-package-lifecycle.md | markdown | 13.9 KB |
| references/cowork-sandbox-findings.md | markdown | 7.0 KB |
| references/cowork-test-playbook.md | markdown | 3.6 KB |
| references/skill-install-routes.md | markdown | 4.7 KB |
| scripts/bundle_skill_companions.py | script | 19.8 KB |
| scripts/cowork_content_checks.py | script | 9.9 KB |
| scripts/cowork_markdown_utils.py | script | 4.8 KB |
| scripts/cowork_package_constants.py | script | 5.2 KB |
| scripts/package_cowork_plugin.py | script | 21.0 KB |
| scripts/scaffold_cowork_package.py | script | 13.4 KB |
| tests/test_bundle_and_scaffold.py | script | 10.9 KB |
| tests/test_content_checks.py | script | 8.9 KB |
| tests/test_package_cowork_plugin.py | script | 9.2 KB |
SKILL.md
View on GitHub---
name: packaging-copilot-cowork-plugins
plugin: agent-extension-authoring
description: >-
Creates, validates and prepares Microsoft 365 Copilot Cowork plugin App Packages
containing Agent Skills and optional remote MCP connectors. Use when scaffolding,
converting, validating, provisioning, packaging or sharing a Cowork plugin. Not for
APM package creation or installation (use packaging-with-apm).
argument-hint: "[create|convert|validate|package|share] [plugin path]"
allowed-tools: Bash, Read, Write, Glob, Grep
---
# Packaging Copilot Cowork Plugins
Creates and validates Microsoft 365 app packages for Copilot Cowork plugins. A package
contains the plugin manifest, icons, and one or more skills; it may also declare remote
MCP connectors.
## Contents
- [Constraints](#constraints)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
## Constraints
- Package the plugin as an M365 App Package `.zip`; do not treat each skill as a
separate app package.
- Keep each skill portable and self-contained. Packaged scripts ran in some Cowork sessions
and were absent from the command sandbox in others: give a fallback and put must-run
functionality behind a remote MCP connector. See
[capabilities and limits](references/cowork-capabilities-and-limits.md).
- Publish rejects some file types (e.g. `.mmd`) and allows 20 companion files per skill; use the scripts.
- WIQD is preview software. Check its current official documentation and exact
installed version, then pin the tested version in repository or CI setup. Do not
guess a version or assume command compatibility.
- Do not authenticate, provision, share, publish, or delete tenant resources without
explicit user approval for the target tenant and scope. Never request or store
passwords, tokens, or client secrets in skill files or package artifacts.
- Inspect existing files before editing. Do not overwrite source skills, manifests,
icons, or environment configuration without approval.
## Quick start
Identify whether the source is a WIQD project or a Claude/Open Plugin project, and read
[the package lifecycle](references/cowork-package-lifecycle.md) for the route. Without
WIQD, build locally from an APM plugin in two steps:
```bash
python scripts/scaffold_cowork_package.py --apm-plugin <plugin> --output <dir>/appPackage \
--developer-name <name> --website-url <url> --privacy-url <url> --terms-url <url>
python scripts/package_cowork_plugin.py --plugin-path <dir>/appPackage --output-path <output.zip>
```
The scaffold bundles over-limit skills and filters unsupported file types; the packager
checks the manifest, `SKILL.md` frontmatter, links and file types.
## Workflow
1. Reuse supplied requirements. Confirm the plugin name, skills to include, connector
endpoint and auth expectations, privacy/terms URLs for conversion when needed, and
whether the user wants only a local ZIP or tenant-side actions.
2. Follow the relevant lifecycle route in
[the package lifecycle](references/cowork-package-lifecycle.md). When building
from scratch, follow its source-authoring route before creating the M365 package.
Keep generated package files under the selected project; do not copy server
executables into the app package.
3. Validate the built ZIP and inspect its contents before delivery. Report the exact
artifact path, validation result, tool version, and any unperformed tenant actions.
4. If publish validation rejects something missed, fix the tools here and rebuild. Other routes: [install routes](references/skill-install-routes.md). What Cowork's sandbox does with scripts and binaries: [sandbox findings](references/cowork-sandbox-findings.md), [test playbook](references/cowork-test-playbook.md), [deterministic or generative](references/cowork-deterministic-vs-generative.md).
## Verification
Check that the ZIP has a valid manifest, required icons, and exactly the intended skill
folders and connector declarations; ensure it contains no credentials, local secrets,
or unintended files. Verify deep validation applies to the final artifact, not only an
earlier draft. Do not report tenant sharing or publication as complete unless it was
explicitly approved and confirmed. See
[acceptance criteria](references/acceptance-criteria.md) for the completion contract.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |