UAT: agents skill refresh command is implemented but absent from spec CLI synopsis #3915

Closed
opened 2026-04-06 07:22:42 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: docs/spec-add-skill-refresh-synopsis
  • Commit Message: docs(spec): add agents skill refresh to CLI synopsis
  • Milestone: Backlog (see note below)
  • Parent Epic: #3374

Background

The implementation includes an agents skill refresh command in src/cleveragents/cli/commands/skill.py (line 917+). However, the docs/specification.md CLI Command Synopsis section (lines 290-294) only lists agents skill add, agents skill remove, agents skill list, agents skill show, and agents skill toolsagents skill refresh is absent.

Per the project's Specification-First Development principle, the spec is the authoritative source of truth. Any command that is implemented must be documented in the spec's CLI synopsis.

What Was Tested

Compared the CLI command synopsis in docs/specification.md (lines 290-294) against the registered skill commands in src/cleveragents/cli/commands/skill.py.

Expected Behavior (from spec)

The spec's CLI synopsis is the authoritative list of all supported commands. Any command implemented should be documented in the spec.

Actual Behavior

The agents skill refresh command is implemented (with --all flag support) but is not listed in the spec's CLI synopsis section.

Code Locations

  • src/cleveragents/cli/commands/skill.py line 917 (def refresh)
  • docs/specification.md lines 290-294 (CLI synopsis — missing skill refresh)

Steps to Reproduce

  1. Search docs/specification.md for "skill refresh" — no results in CLI synopsis
  2. Run agents skill refresh --help — command exists and works

Impact

The spec is the source of truth. The spec needs to be updated to document the agents skill refresh command (including its --all flag), or the command needs to be removed until the spec describes it.

Subtasks

  • Confirm the full signature of agents skill refresh in src/cleveragents/cli/commands/skill.py (line 917+), including all flags and options
  • Update docs/specification.md CLI Command Synopsis section (lines 290-294) to include agents skill refresh [--all]
  • Add any relevant description of the skill refresh command's purpose and behaviour to the spec narrative (if a prose section exists for skill commands)
  • Verify no other skill sub-commands are similarly absent from the spec synopsis
  • Run nox -e lint and nox -e typecheck to confirm no regressions from doc changes

Definition of Done

  • docs/specification.md CLI synopsis includes agents skill refresh [--all] with accurate description
  • No other skill sub-commands are missing from the CLI synopsis
  • All nox stages pass
  • Coverage >= 97%
  • PR merged and issue closed

Backlog note: This issue was discovered during autonomous operation
on milestone v3.6.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.


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

## Metadata - **Branch**: `docs/spec-add-skill-refresh-synopsis` - **Commit Message**: `docs(spec): add agents skill refresh to CLI synopsis` - **Milestone**: Backlog (see note below) - **Parent Epic**: #3374 ## Background The implementation includes an `agents skill refresh` command in `src/cleveragents/cli/commands/skill.py` (line 917+). However, the `docs/specification.md` CLI Command Synopsis section (lines 290-294) only lists `agents skill add`, `agents skill remove`, `agents skill list`, `agents skill show`, and `agents skill tools` — `agents skill refresh` is absent. Per the project's **Specification-First Development** principle, the spec is the authoritative source of truth. Any command that is implemented must be documented in the spec's CLI synopsis. ## What Was Tested Compared the CLI command synopsis in `docs/specification.md` (lines 290-294) against the registered skill commands in `src/cleveragents/cli/commands/skill.py`. ## Expected Behavior (from spec) The spec's CLI synopsis is the authoritative list of all supported commands. Any command implemented should be documented in the spec. ## Actual Behavior The `agents skill refresh` command is implemented (with `--all` flag support) but is **not listed** in the spec's CLI synopsis section. ## Code Locations - `src/cleveragents/cli/commands/skill.py` line 917 (`def refresh`) - `docs/specification.md` lines 290-294 (CLI synopsis — missing `skill refresh`) ## Steps to Reproduce 1. Search `docs/specification.md` for "skill refresh" — no results in CLI synopsis 2. Run `agents skill refresh --help` — command exists and works ## Impact The spec is the source of truth. The spec needs to be updated to document the `agents skill refresh` command (including its `--all` flag), or the command needs to be removed until the spec describes it. ## Subtasks - [ ] Confirm the full signature of `agents skill refresh` in `src/cleveragents/cli/commands/skill.py` (line 917+), including all flags and options - [ ] Update `docs/specification.md` CLI Command Synopsis section (lines 290-294) to include `agents skill refresh [--all]` - [ ] Add any relevant description of the `skill refresh` command's purpose and behaviour to the spec narrative (if a prose section exists for skill commands) - [ ] Verify no other skill sub-commands are similarly absent from the spec synopsis - [ ] Run `nox -e lint` and `nox -e typecheck` to confirm no regressions from doc changes ## Definition of Done - [ ] `docs/specification.md` CLI synopsis includes `agents skill refresh [--all]` with accurate description - [ ] No other skill sub-commands are missing from the CLI synopsis - [ ] All nox stages pass - [ ] Coverage >= 97% - [ ] PR merged and issue closed > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.6.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester
Author
Owner

Duplicate of #3810

This issue covers the same problem as #3810: agents skill refresh is implemented but absent from the spec's CLI synopsis. Issue #3810 was filed earlier (2026-04-06T06:31:39Z vs this issue at 2026-04-06T07:22:42Z) and contains a more detailed analysis including the full command signature and both resolution paths (update spec vs remove command). Closing as a duplicate — please track the fix in #3810.


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

**Duplicate of #3810** This issue covers the same problem as #3810: `agents skill refresh` is implemented but absent from the spec's CLI synopsis. Issue #3810 was filed earlier (2026-04-06T06:31:39Z vs this issue at 2026-04-06T07:22:42Z) and contains a more detailed analysis including the full command signature and both resolution paths (update spec vs remove command). Closing as a duplicate — please track the fix in #3810. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#3915
No description provided.