UAT: `agents skill show/tools` JSON output capability_summary field names don't match spec #4545

New issue

Open

opened 2026-04-08 14:23:09 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-08 14:23:09 +00:00

Owner

Bug Report

Feature Area: Skills CLI — agents skill show --format json and agents skill tools --format json capability_summary field names

Expected Behavior (from spec)

The spec (Section "agents skill show", lines 7126-7133) shows the JSON capability_summary with these field names:

"capability_summary": {
  "total_tools": 23,
  "read_only": 10,
  "writes": 13,
  "checkpointable": 10,
  "has_side_effects": 3,
  "requires_approval": 1
}

Actual Behavior (from code)

In src/cleveragents/cli/commands/skill.py, show command (lines ~770-780):

data["capability_summary"] = {
    "total_tools": summary.total_tools,
    "read_only_tools": summary.read_only_tools,      # spec: "read_only"
    "write_tools": summary.write_tools,              # spec: "writes"
    "checkpointable_tools": summary.checkpointable_tools,  # spec: "checkpointable"
    "has_side_effects": summary.has_side_effects,
    # missing: "requires_approval"
}

Three field names are wrong and one field is missing:

Spec Field	Implementation Field	Status
`read_only`	`read_only_tools`	❌ Wrong name
`writes`	`write_tools`	❌ Wrong name
`checkpointable`	`checkpointable_tools`	❌ Wrong name
`requires_approval`	(missing)	❌ Missing

Impact

Any programmatic consumer of agents skill show --format json or agents skill tools --format json will receive wrong field names, breaking API compatibility with the spec.

Code Location

src/cleveragents/cli/commands/skill.py, show command (~line 770)
src/cleveragents/cli/commands/skill.py, tools command (~line 870)
src/cleveragents/cli/commands/skill.py, list_skills command (~line 700)

Fix Suggestion

Update the JSON output to use spec-compliant field names:

data["capability_summary"] = {
    "total_tools": summary.total_tools,
    "read_only": summary.read_only_tools,
    "writes": summary.write_tools,
    "checkpointable": summary.checkpointable_tools,
    "has_side_effects": summary.has_side_effects,
    "requires_approval": summary.requires_approval,  # after adding to model
}

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** Skills CLI — `agents skill show --format json` and `agents skill tools --format json` capability_summary field names ### Expected Behavior (from spec) The spec (Section "agents skill show", lines 7126-7133) shows the JSON capability_summary with these field names: ```json "capability_summary": { "total_tools": 23, "read_only": 10, "writes": 13, "checkpointable": 10, "has_side_effects": 3, "requires_approval": 1 } ``` ### Actual Behavior (from code) In `src/cleveragents/cli/commands/skill.py`, `show` command (lines ~770-780): ```python data["capability_summary"] = { "total_tools": summary.total_tools, "read_only_tools": summary.read_only_tools, # spec: "read_only" "write_tools": summary.write_tools, # spec: "writes" "checkpointable_tools": summary.checkpointable_tools, # spec: "checkpointable" "has_side_effects": summary.has_side_effects, # missing: "requires_approval" } ``` Three field names are wrong and one field is missing: | Spec Field | Implementation Field | Status | |---|---|---| | `read_only` | `read_only_tools` | ❌ Wrong name | | `writes` | `write_tools` | ❌ Wrong name | | `checkpointable` | `checkpointable_tools` | ❌ Wrong name | | `requires_approval` | (missing) | ❌ Missing | ### Impact Any programmatic consumer of `agents skill show --format json` or `agents skill tools --format json` will receive wrong field names, breaking API compatibility with the spec. ### Code Location - `src/cleveragents/cli/commands/skill.py`, `show` command (~line 770) - `src/cleveragents/cli/commands/skill.py`, `tools` command (~line 870) - `src/cleveragents/cli/commands/skill.py`, `list_skills` command (~line 700) ### Fix Suggestion Update the JSON output to use spec-compliant field names: ```python data["capability_summary"] = { "total_tools": summary.total_tools, "read_only": summary.read_only_tools, "writes": summary.write_tools, "checkpointable": summary.checkpointable_tools, "has_side_effects": summary.has_side_effects, "requires_approval": summary.requires_approval, # after adding to model } ``` --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added this to the v3.5.0 milestone

2026-04-08 17:41:44 +00:00

HAL9000 added the