github/spec-kit · error · ValidationError

Duplicate command or alias '{name}' in extension manifest

Error message

Duplicate command or alias '{name}' in extension manifest

What it means

Error "Duplicate command or alias '{name}' in extension manifest" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/extensions/__init__.py:1149

                    if match is None:
                        raise ValidationError(
                            f"Invalid {kind} '{name}': "
                            "must follow pattern 'speckit.{extension}.{command}'"
                        )

                    namespace = match.group(1)
                    if namespace != manifest.id:
                        raise ValidationError(
                            f"{kind.capitalize()} '{name}' must use extension namespace '{manifest.id}'"
                        )

                    if namespace in CORE_COMMAND_NAMES:
                        raise ValidationError(
                            f"{kind.capitalize()} '{name}' conflicts with core command namespace '{namespace}'"
                        )

                if name in declared_names:
                    raise ValidationError(
                        f"Duplicate command or alias '{name}' in extension manifest"
                    )

                declared_names[name] = kind

        return declared_names

    def _get_installed_command_name_map(
        self,
        exclude_extension_id: Optional[str] = None,
    ) -> Dict[str, str]:
        """Return registered command and alias names for installed extensions."""
        installed_names: Dict[str, str] = {}

        for ext_id in self.registry.keys():
            if ext_id == exclude_extension_id:
                continue

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Remove the duplicate command or alias name from the extension manifest so each name is unique.

When it happens

Trigger: Thrown at src/specify_cli/extensions/__init__.py:1149 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/3478345abde6eb2b. Report an issue: GitHub.