Skip to content

--skills-only --scope project incorrectly skips Codex #6284

Description

@rob7thousand

Describe the issue

databricks aitools install skips Codex when --scope project and
--skills-only are used together:

Skipped Codex CLI: does not support project-scoped skills

Codex supports repository-scoped raw skills under
<repo>/.agents/skills:

https://developers.openai.com/codex/skills#where-codex-loads-local-skills

Codex does not appear to support project-scoped plugin installation:
codex plugin add and codex plugin marketplace add expose no project
or --scope option. However, plugin scope should not prevent installation
when --skills-only explicitly requests raw skill files.

Steps to reproduce

Run from a project directory:

databricks aitools install \
  --agents claude-code,codex \
  --scope project \
  --skills-only

Expected behavior

Because --skills-only explicitly requests raw skill files, the CLI should
install the Codex skills into:

<project>/.agents/skills

Claude Code should continue using:

<project>/.claude/skills

Whether Codex plugins support project scope should not affect the
--skills-only installation path.

Actual behavior

Claude Code is processed, but Codex is skipped:

Skipped Codex CLI: does not support project-scoped skills

Possible cause

The agent model appears to use a single SupportsProjectScope capability:

https://github.com/databricks/cli/blob/main/libs/aitools/agents/agents.go

The Codex registry entry does not set SupportsProjectScope or
ProjectConfigDir, so SupportsProjectScope defaults to false.

This may correctly reflect the lack of project-scoped Codex plugin
installation, but it also blocks project-scoped raw skills when
--skills-only is used.

The capabilities may need to be distinguished by delivery method, for
example:

  • Project-scoped plugin installation
  • Project-scoped raw-skill installation

For Codex, raw-skill project scope should be enabled with a project
configuration directory of .agents, producing:

<project>/.agents/skills

Environment

Databricks CLI v1.12.1
Codex CLI 0.147.0

Related issue

Related to #6037, which proposes installing skills into the
vendor-neutral .agents/skills directory. This report specifically
concerns --skills-only being rejected because Codex plugin and
raw-skill scope capabilities appear to be treated as one capability.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions