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/cowork-test-playbook.md
View on GitHub# Cowork Test Playbook
How to test what a Cowork skill can do without being fooled by stale files, missing
attachments or a model's confident summary. Built from the 2026-11-18 experiments.
## Contents
- [Before each test](#before-each-test)
- [Making a run provable](#making-a-run-provable)
- [Building and shipping a binary](#building-and-shipping-a-binary)
- [Prompt shapes that worked](#prompt-shapes-that-worked)
- [Reading a result](#reading-a-result)
## Before each test
1. **New name per build.** Re-uploading under the same name left Cowork on the old files.
Give each test build a new skill name and ZIP name. (Deleting the old skill first may also
work but is untested.)
2. **Wait for the sync.** Users reported 2 to 3 minutes before a changed skill was usable.
Start a new task afterwards.
3. **Finish uploads first.** Send the message only when the attachment shows as uploaded. One
run saw an empty input folder.
4. **Ask for the skill name and file list first.** A reply that names the wrong skill or old
files shows a stale load before anything else is wasted.
## Making a run provable
- Bake a **build id** into the binary and ship the expected id in a small text file in the skill's assets folder.
Check it with `grep -c <id> <file>` without executing. Cowork declined `--version`.
- Ship **expected outputs** and their SHA-256 values; deterministic programs reproduce them
exactly. Have the agent state `match` or `differ` for each.
- Derive values (colors, hashes) from the input and print a per-run id, so the agent cannot
guess them.
- Require the agent to paste output verbatim, say which tools failed, and say where files
were saved.
## Building and shipping a binary
```bash
rustup target add x86_64-unknown-linux-musl
RUSTFLAGS="-C linker=rust-lld -C link-self-contained=yes" \
cargo build --release --target x86_64-unknown-linux-musl
```
Use `opt-level = "z"`, `lto`, `strip` and `panic = "abort"` to stay near 0.5 MB. Test under
WSL. Inside Cowork run it as
`cp <copy> /tmp/prog && chmod +x /tmp/prog && env -i /tmp/prog <dir>`, so the program does not
inherit the session's credentials.
For a browser page, build the shared logic as WebAssembly instead:
```bash
rustup target add wasm32-unknown-unknown
cargo build --release --lib --target wasm32-unknown-unknown # crate-type includes "cdylib"
```
Export plain `extern "C"` functions, embed the `.wasm` as base64 in one HTML file, and load it
with `WebAssembly.instantiate`. That works from a file with no server. Test the module in
Node before shipping.
## Prompt shapes that worked
- State that the program was built from the user's own source and that running it is
approved. Without it Cowork may refuse.
- Name the folders: attachments land in `/mnt/workspace/input`; run from `/tmp`.
- Ask it to try each available file tool when a file is missing and report every failure,
instead of accepting "I cannot".
- Ask it to save generated files to the task output folder and show them.
## Reading a result
| Reply says | Meaning |
|---|---|
| Names an older skill or build id | Stale skill; rename and retry |
| "Folder not found" for the skill path | Skill files are not in the sandbox; use the viewer or an attachment |
| "Permission denied", exit 126 | Ran in the workspace; run from `/tmp` |
| Input folder empty | Attachment not uploaded in time |
| Prints your build id and matching hashes | Genuine run of the current files |
Do not ask a test program to dump the environment. The sandbox environment held service
credentials in a test (see [the security notes](cowork-sandbox-findings.md#security)).
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 |