{"record":{"id":"d879f29cfc05d906","repo":"openai/openai-python","slug":"expected-a-non-empty-value-for-skill-id-but-rece-d879f2","errorCode":null,"errorMessage":"Expected a non-empty value for `skill_id` but received {skill_id!r}","messagePattern":"Expected a non-empty value for `skill_id` but received (.+?)","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"src/openai/resources/skills/versions/content.py","lineNumber":70,"sourceCode":"        extra_body: Body | None = None,\n        timeout: float | httpx2.Timeout | None | NotGiven = not_given,\n    ) -> _legacy_response.HttpxBinaryResponseContent:\n        \"\"\"\n        Download a skill version zip bundle.\n\n        Args:\n          version: The skill version number.\n\n          extra_headers: Send extra headers\n\n          extra_query: Add additional query parameters to the request\n\n          extra_body: Add additional JSON properties to the request\n\n          timeout: Override the client-level default timeout for this request, in seconds\n        \"\"\"\n        if not skill_id:\n            raise ValueError(f\"Expected a non-empty value for `skill_id` but received {skill_id!r}\")\n        if not version:\n            raise ValueError(f\"Expected a non-empty value for `version` but received {version!r}\")\n        extra_headers = {\"Accept\": \"application/binary\", **(extra_headers or {})}\n        return self._get(\n            path_template(\"/skills/{skill_id}/versions/{version}/content\", skill_id=skill_id, version=version),\n            options=make_request_options(\n                extra_headers=extra_headers,\n                extra_query=extra_query,\n                extra_body=extra_body,\n                timeout=timeout,\n                security={\"bearer_auth\": True},\n            ),\n            cast_to=_legacy_response.HttpxBinaryResponseContent,\n        )\n\n\nclass AsyncContent(AsyncAPIResource):\n    @cached_property","sourceCodeStart":52,"sourceCodeEnd":88,"githubUrl":"https://github.com/openai/openai-python/blob/9917c6e28e66e90e1227b3d223c06a8c5441515a/src/openai/resources/skills/versions/content.py#L52-L88","documentation":"Sync skill-version content download (GET /skills/{skill_id}/versions/{version}/content) validates skill_id first. Both path parameters are checked in order (skill_id before version), so this variant fires when skill_id is empty even if version is valid.","triggerScenarios":"Calling client.skills.versions.content.retrieve(skill_id=\"\", version=\"v3\") — or with None skill_id — when downloading a specific version's binary bundle.","commonSituations":"Downloading versioned skill bundles in CI or packaging scripts where the skill ID comes from a manifest field that is blank; parameter ordering mistakes when both args are positional.","solutions":["Populate skill_id from a prior list/create call and retry","Validate both path params before the call","Check the manifest/config producing the empty value"],"exampleFix":"# before\ndata = client.skills.versions.content.retrieve(\"\", \"v3\")\n\n# after\ndata = client.skills.versions.content.retrieve(\"skill-abc123\", \"v3\")","handlingStrategy":"validation","validationCode":"if not (isinstance(skill_id, str) and skill_id.strip()):\n    raise ValueError(\"skill_id is required\")\nif not (isinstance(version, str) and version.strip()):\n    raise ValueError(\"version is required\")\ndata = client.skills.versions.content.retrieve(skill_id, version)","typeGuard":"def is_valid_skill_version_ref(skill_id: object, version: object) -> bool:\n    return (\n        isinstance(skill_id, str) and bool(skill_id.strip())\n        and isinstance(version, str) and bool(version.strip())\n    )","tryCatchPattern":null,"preventionTips":["Validate both path params together in download helpers","Source (skill_id, version) pairs from list() responses, not hand-edited files","Add manifest schema validation in CI packaging scripts"],"tags":["skills","versions","content","validation","path-parameter"],"backgroundTag":"required-parameter-missing","analyzedSha":"9917c6e28e66e90e1227b3d223c06a8c5441515a","analyzedAt":"2026-08-28T11:46:34.183Z","schemaVersion":2},"datasetVersion":"2026-08-28T16:17:29.566Z"}