github/spec-kit · error · ValueError

Workflow package contains unsupported file: {path}

Error message

Workflow package contains unsupported file: {path}

What it means

Error "Workflow package contains unsupported file: {path}" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/workflows/_commands.py:955

    raise ValueError(
        "Archive must contain workflow.yml at its root or in exactly one "
        "top-level directory"
    )


def _validate_local_workflow_package(package_dir: Path) -> None:
    """Reject links and special files before copying a local package."""
    import stat

    for root, dirnames, filenames in os.walk(package_dir, followlinks=False):
        root_path = Path(root)
        for name in [*dirnames, *filenames]:
            path = root_path / name
            mode = path.lstat().st_mode
            if stat.S_ISLNK(mode):
                raise ValueError(f"Workflow package contains symlink: {path}")
            if not stat.S_ISDIR(mode) and not stat.S_ISREG(mode):
                raise ValueError(f"Workflow package contains unsupported file: {path}")


def _workflow_package_has_companions(package_dir: Path) -> bool:
    """Return whether a directory contains anything beyond workflow.yml."""
    return any(path.name != "workflow.yml" for path in package_dir.iterdir())


def _install_workflow_package(
    project_root: Path,
    workflows_dir: Path,
    package_dir: Path,
    source_label: str,
    *,
    expected_id: str | None = None,
    expected_version: str | None = None,
    expected_installed_version: str | None = None,
    catalog_info: dict[str, Any] | None = None,
) -> None:

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Remove the unsupported file from the workflow package and repackage it.

When it happens

Trigger: Thrown at src/specify_cli/workflows/_commands.py:955 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/876b74430b952816. Report an issue: GitHub.