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 |
references/acceptance-criteria.md
View on GitHub# Acceptance Criteria: packaging-copilot-cowork-plugins
## Create or convert
- The output is a Microsoft 365 Copilot Cowork app package, not an APM bundle.
- The package ZIP has `manifest.json` at its root, required icons, and the intended
skill folders registered in `agentSkills`.
- Any requested MCP connector is represented as a remote service reference; its server
implementation is not described as bundled or locally executable.
- Existing Claude/Open Plugin conversion uses Microsoft's current route and reports
unsupported source features and unresolved connector placeholders.
## Validate and package
- The exact WIQD version and supported command options are checked before use because
WIQD is preview software.
- Static and deep validation results are reported separately; deep validation covers
the final ZIP before upload.
- Manual local packaging is identified as a fallback and does not claim to replace
Microsoft's App Validation Library.
- Existing outputs and source files are not overwritten without explicit approval.
- The final ZIP is checked for expected contents, integrity, symbolic links, hidden
files, and likely credential files.
## Tenant actions
- Authentication, provisioning, sharing, publication, and deletion are treated as
external side effects requiring explicit user approval for tenant and scope.
- Connector authorization is not claimed complete merely because the package declares
a connector.
- The final report distinguishes local packaging from any tenant-side action actually
completed.
## Local packager
- `package_cowork_plugin.py` accepts an explicit plugin path and output ZIP path.
- It refuses invalid package roots, malformed manifest references, missing skills or
icons, wrong icon dimensions, symbolic links, and likely credential files.
- It preserves an existing destination unless `--overwrite` is explicitly supplied.
- It includes each skill's `SKILL.md`, `references/`, `assets/` and `scripts/`, and
excludes only source-only `evals/` and `tests/` directories, reporting what was omitted.
- It rejects a skill with more than 20 companion files, any over 5 MB, or over 10 MB total.
- Focused tests cover successful packaging, path traversal, icon validation, and
overwrite behavior.
## Scaffold, bundle and content checks
- `scaffold_cowork_package.py` takes explicit developer, privacy and terms values and never
invents URLs; it refuses an existing output folder and produces a manifest, both icons and
skill folders the packager accepts.
- `bundle_skill_companions.py` never modifies the source skill, leaves skills within the limit
unchanged, rewrites every link when bundling, filters unsupported file types and excluded
files with plain-text replacements, and fails with an actionable message if a skill still
exceeds the limit.
- The packager fails on incomplete or out-of-range manifest metadata, mismatched or missing
`SKILL.md` frontmatter, broken or folder-targeting relative links, and unsupported file types,
and warns on missing heading anchors.
- Tests cover each behavior above in addition to the original packaging cases.
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 |