Skip to content

wp-performance: wp doctor check without arguments errors instead of running checks #113

Closed

Description

@maheshbohara

Skill

wp-performance

Problem

The skill tells agents to run wp doctor check with no arguments as the first diagnostic step. That command doesn't run any checks; it exits with an error:

$ wp doctor check
Error: Please specify one or more checks, or use --all.

Source: wp-cli/doctor-command src/Command.php L120-L123:

$all = Utils\get_flag_value( $assoc_args, 'all' );
if ( empty( $args ) && ! $all ) {
	WP_CLI::error( 'Please specify one or more checks, or use --all.' );
}

An agent following the skill hits this error at step 2 ("Fast wins") and either stops or has to guess the fix.

Affected places:

  • skills/wp-performance/SKILL.md:58: wp doctor check listed as the preferred fast diagnostic
  • skills/wp-performance/SKILL.md:129: verification step "wp doctor check is clean"
  • skills/wp-performance/references/wp-cli-doctor.md:16: "Recommended usage: wp doctor check"
  • eval/scenarios/performance-profile-slow-endpoint.json:9,19: expected behaviour "Run wp doctor check first" / "Uses wp doctor check first"

(eval/scenarios/performance-autoload-options-bloat.json:9 already uses the correct form, wp doctor check autoload-options-size.)

Correct behaviour

Use --all or name the checks:

  • wp doctor check --all for a full sweep
  • wp doctor check autoload-options-size constant-savequeries-falsy constant-wp-debug-falsy for a perf-focused run
  • optionally --spotlight to show only failures and warnings

Proposed fix

  • SKILL.md step 2 and the Verification section: wp doctor check --all (and mention the targeted form)
  • references/wp-cli-doctor.md: replace the bare command with --all, the targeted perf example, and --spotlight
  • performance-profile-slow-endpoint.json: update the step and the expected behaviour to wp doctor check --all (or the targeted checks)

Activity

  1. added a commit that references this issue on Oct 5, 2026
    3cf7f6f
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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