github/spec-kit · error · ValueError

Downloaded extension archive is missing 'extension.yml'

Error message

Downloaded extension archive is missing 'extension.yml'

What it means

Error "Downloaded extension archive is missing 'extension.yml'" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/extensions/_commands.py:1970

                                if entry.name.casefold() == "extension.yml"
                            ]
                            if any(
                                entry.name != "extension.yml"
                                for entry in nested_manifest_entries
                            ):
                                raise ValueError(
                                    "Archive must use canonical 'extension.yml' casing"
                                )
                            manifest_path = next(
                                (
                                    entry
                                    for entry in nested_manifest_entries
                                    if entry.name == "extension.yml"
                                ),
                                manifest_root / "extension.yml",
                            )
                        if not manifest_path.is_file():
                            raise ValueError(
                                "Downloaded extension archive is missing 'extension.yml'"
                            )
                        manifest_bytes = manifest_path.read_bytes()
                        parsed_manifest = yaml.safe_load(manifest_bytes)
                        manifest_data = (
                            parsed_manifest if parsed_manifest is not None else {}
                        )
                        if not isinstance(manifest_data, dict):
                            raise ValueError(
                                "Invalid extension manifest in downloaded archive: "
                                "expected YAML mapping"
                            )
                        extension_data = manifest_data.get("extension", {})
                        if not isinstance(extension_data, dict):
                            raise ValueError(
                                "Invalid extension manifest in downloaded archive: "
                                "expected 'extension' mapping"
                            )

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Add an 'extension.yml' manifest to the top level of the archive's single root directory.

When it happens

Trigger: Thrown at src/specify_cli/extensions/_commands.py:1970 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/f8032f53ab9f640b. Report an issue: GitHub.