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 |
scripts/cowork_package_constants.py
View on GitHub"""
Copilot Cowork package constants
================================
Purpose:
Define the M365 app-package names and checks shared by the local ZIP packager
and its tests.
Key Input Dependencies:
None. Values describe the current Cowork app-package layout.
Key Functions:
None.
Output:
Imported package-layout, icon, path-safety, and archive constants.
"""
from typing import Dict, Tuple
MANIFEST_FILE_NAME = "manifest.json"
APP_PACKAGE_DIRECTORY_NAME = "appPackage"
ICONS_KEY = "icons"
COLOR_ICON_KEY = "color"
OUTLINE_ICON_KEY = "outline"
COLOR_ICON_FILE_NAME = "color.png"
OUTLINE_ICON_FILE_NAME = "outline.png"
COLOR_ICON_DIMENSIONS = (192, 192)
OUTLINE_ICON_DIMENSIONS = (32, 32)
ICON_DIMENSIONS: Dict[str, Tuple[int, int]] = {
COLOR_ICON_KEY: COLOR_ICON_DIMENSIONS,
OUTLINE_ICON_KEY: OUTLINE_ICON_DIMENSIONS,
}
ICON_FILE_NAMES: Dict[str, str] = {
COLOR_ICON_KEY: COLOR_ICON_FILE_NAME,
OUTLINE_ICON_KEY: OUTLINE_ICON_FILE_NAME,
}
AGENT_SKILLS_KEY = "agentSkills"
SKILL_FOLDER_KEY = "folder"
SKILLS_DIRECTORY_NAME = "skills"
SKILL_FILE_NAME = "SKILL.md"
ZIP_FILE_SUFFIX = ".zip"
ZIP_COMPRESSION_LEVEL = 9
PNG_SIGNATURE = b"\x89PNG\r\n\x1a\n"
PNG_IHDR_CHUNK_TYPE = b"IHDR"
PNG_HEADER_LENGTH = 24
TEMP_ARCHIVE_PREFIX = ".cowork-package-"
FORBIDDEN_PATH_CHARACTERS = frozenset(("\\", ":"))
SENSITIVE_FILE_NAMES = frozenset(("credentials.json", "secrets.json"))
SENSITIVE_FILE_SUFFIXES = frozenset((".env", ".key", ".pem", ".p12", ".pfx", ".token"))
NON_PACKAGE_DIRECTORY_NAMES = frozenset(("evals", "tests"))
# Microsoft Learn "Build plugins for Copilot Cowork": per-skill companion file limits.
MAX_COMPANION_FILES = 20
MAX_COMPANION_FILE_BYTES = 5 * 1024 * 1024
MAX_COMPANION_TOTAL_BYTES = 10 * 1024 * 1024
# --- Manifest metadata (Microsoft 365 / Teams app manifest rules) ---
MANIFEST_VERSION_KEY = "manifestVersion"
MANIFEST_APP_VERSION_KEY = "version"
MANIFEST_ID_KEY = "id"
MANIFEST_DEVELOPER_KEY = "developer"
MANIFEST_NAME_KEY = "name"
MANIFEST_DESCRIPTION_KEY = "description"
MANIFEST_ACCENT_COLOR_KEY = "accentColor"
SHORT_KEY = "short"
FULL_KEY = "full"
DEVELOPER_NAME_KEY = "name"
DEVELOPER_URL_KEYS = ("websiteUrl", "privacyUrl", "termsOfUseUrl")
DEVELOPER_NAME_MAX = 32
NAME_SHORT_MAX = 30
NAME_FULL_MAX = 100
DESCRIPTION_SHORT_MAX = 80
DESCRIPTION_FULL_MAX = 4000
URL_MAX_LENGTH = 2048
HTTPS_PREFIX = "https://"
GUID_PATTERN = r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
APP_VERSION_PATTERN = r"^\d+\.\d+\.\d+$"
ACCENT_COLOR_PATTERN = r"^#[0-9A-Fa-f]{6}$"
DEFAULT_MANIFEST_VERSION = "1.29"
DEFAULT_ACCENT_COLOR = "#2B579A"
APP_ID_NAMESPACE = "https://learn.microsoft.com/copilot/cowork/app-id"
# --- Agent Skills entry point checks ---
SKILL_NAME_PATTERN = r"^[a-z0-9]+(-[a-z0-9]+)*$"
SKILL_NAME_MAX = 64
SKILL_DESCRIPTION_MAX = 1024
FRONTMATTER_DELIMITER = "---"
# --- Markdown handling ---
MARKDOWN_SUFFIX = ".md"
MARKDOWN_LINK_PATTERN = r"(?<!!)\[([^\]]*)\]\(([^)\s]+)\)"
CODE_FENCE_PREFIX = "```"
EXTERNAL_LINK_PREFIXES = ("http://", "https://", "mailto:")
CONTENTS_HEADING = "## Contents"
HORIZONTAL_RULE = "---"
# --- Source skill layout, bundling and scaffolding ---
REFERENCES_DIRECTORY_NAME = "references"
ASSETS_DIRECTORY_NAME = "assets"
SCRIPTS_DIRECTORY_NAME = "scripts"
SKILL_COMPANION_DIRECTORIES = (
REFERENCES_DIRECTORY_NAME,
ASSETS_DIRECTORY_NAME,
SCRIPTS_DIRECTORY_NAME,
)
IGNORED_DIRECTORY_NAMES = frozenset(("__pycache__",))
IGNORED_FILE_SUFFIXES = frozenset((".pyc",))
ACCEPTANCE_CRITERIA_FILE_NAME = "acceptance-criteria.md"
LOOSE_GUIDES_BUNDLE = "references/other.md"
# File types Microsoft 365 Copilot works with, from Microsoft Support's list of supported file formats
# (supplied by the user). Cowork publish validation rejected ".mmd" with "not supported ... in
# Microsoft 365 Copilot". This list is not confirmed to be the validator's exact allowlist, so the
# tools accept --allow-extensions to add types and --drop-extensions to remove them.
SUPPORTED_COMPANION_EXTENSIONS = frozenset((
".js", ".jsx", ".tsx", ".py", ".java", ".cs", ".cpp", ".c", ".h", ".php", ".dart", ".css",
".lua", ".rs", ".pl", ".sql", ".bash", ".sh",
".json", ".xml", ".yaml", ".yml", ".ini", ".config", ".utf8",
".docx", ".doc", ".docm", ".pdf", ".txt", ".rtf", ".md", ".html", ".htm",
".pptx", ".ppt", ".ppsm", ".xlsx", ".xls", ".xlsm", ".csv", ".tsv",
".png", ".jpg", ".jpeg", ".gif", ".bmp", ".log", ".loop", ".fluid",
))
FILE_TYPE_NOT_SUPPORTED_NOTE = "file type not supported in Cowork"
DROPPED_LINK_TARGET = ""
SCRIPT_NOT_PACKAGED_NOTE = "script, not packaged in Cowork"
COWORK_BUILD_HEADING = "## Cowork build"
BUNDLE_SECTIONS_HEADING = "## Sections"
APM_SKILLS_RELATIVE_PATH = (".apm", "skills")
PLUGIN_METADATA_RELATIVE_PATH = (".claude-plugin", "plugin.json")
PLUGIN_NAME_KEY = "name"
PLUGIN_VERSION_KEY = "version"
PLUGIN_DESCRIPTION_KEY = "description"
SHORT_DESCRIPTION_ELLIPSIS = "..."
# --- Generated icon geometry ---
COLOR_ICON_BARS = ((36, 120, 32), (80, 90, 32), (124, 56, 32))
COLOR_ICON_BASELINE_Y = 150
COLOR_ICON_RULE = (28, 164, 154, 160)
OUTLINE_ICON_BARS = ((6, 17, 6), (14, 12, 6), (22, 7, 6))
OUTLINE_ICON_BASELINE_Y = 25
OUTLINE_ICON_RULE = (4, 30, 26, 28)
PNG_COLOR_TYPE_RGBA = 6
PNG_BIT_DEPTH = 8
PNG_COMPRESSION_LEVEL = 9
WHITE_RGBA = (255, 255, 255, 255)
TRANSPARENT_RGBA = (0, 0, 0, 0)
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: 471k | 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 |