UAT: `agents skill refresh` is an undocumented command — not present in spec's command synopsis #4845

New issue

Open

opened 2026-04-08 20:07:44 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-08 20:07:44 +00:00

Owner

Bug Report

Feature Area: CLI Commands — agents skill

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/skill.py against the specification's agents skill command surface (spec lines 290–294).

Expected Behavior (from spec)

The spec defines exactly 5 subcommands for agents skill:

agents skill add --config|-c <FILE> [--update]
agents skill remove [--yes|-y] <NAME>
agents skill list [(--namespace|-n) <NS>] [--source <SOURCE>]
agents skill show <NAME>
agents skill tools <NAME>

Actual Behavior

agents skill --help shows 6 subcommands — including an undocumented refresh command:

add      Register a new skill from a YAML configuration file.
remove   Remove a registered skill.
list     List all registered skills.
show     Show full details for a registered skill.
tools    Show the flattened tool list for a skill.
refresh  Recompute tool flattening and sync MCP-backed skills.

The refresh command (line 916 in skill.py) is not in the spec's command synopsis.

Code Location

src/cleveragents/cli/commands/skill.py — lines 916–1000 (refresh command)

Steps to Reproduce

agents skill --help

Impact

The refresh command exposes an undocumented operation that recomputes tool flattening and syncs MCP-backed skills. While this may be useful functionality, it is not in the spec and creates an undocumented API surface. If this command is intentional, it should be added to the spec. If not, it should be removed or hidden.

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

## Bug Report **Feature Area:** CLI Commands — `agents skill` ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/skill.py` against the specification's `agents skill` command surface (spec lines 290–294). ### Expected Behavior (from spec) The spec defines exactly **5** subcommands for `agents skill`: ``` agents skill add --config|-c <FILE> [--update] agents skill remove [--yes|-y] <NAME> agents skill list [(--namespace|-n) <NS>] [--source <SOURCE>] agents skill show <NAME> agents skill tools <NAME> ``` ### Actual Behavior `agents skill --help` shows **6** subcommands — including an undocumented `refresh` command: ``` add Register a new skill from a YAML configuration file. remove Remove a registered skill. list List all registered skills. show Show full details for a registered skill. tools Show the flattened tool list for a skill. refresh Recompute tool flattening and sync MCP-backed skills. ``` The `refresh` command (line 916 in `skill.py`) is not in the spec's command synopsis. ### Code Location - `src/cleveragents/cli/commands/skill.py` — lines 916–1000 (`refresh` command) ### Steps to Reproduce ```bash agents skill --help ``` ### Impact The `refresh` command exposes an undocumented operation that recomputes tool flattening and syncs MCP-backed skills. While this may be useful functionality, it is not in the spec and creates an undocumented API surface. If this command is intentional, it should be added to the spec. If not, it should be removed or hidden. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

Rows
Columns

UAT: agents skill refresh is an undocumented command — not present in spec's command synopsis #4845