Skip to content

[docs-scanner] Broken cross-references to non-existent Docker Agent skills documentation #26190

Description

@docker-agent

File: content/manuals/ai/skills/install.md

Issue

The Docker Agent installation section references a non-existent documentation page twice:

Docker Agent consumes skills installed in its documented
discovery paths; it doesn't install or
update them. Install with the skills CLI or
copy the selected skills to one of those paths...

And later:

See Docker Agent skill
discovery
for paths and configuration.

The path /ai/docker-agent/features/skills/ does not exist. The content/manuals/ai/docker-agent/ directory contains only _index.md with no subdirectories. The Docker Agent index page (content/manuals/ai/docker-agent/_index.md) makes no mention of skills, skill discovery paths, or the skills: configuration field shown in the example.

Why this matters

Readers following the Docker Agent installation instructions are directed to a page that doesn't exist for critical information about:

  • Where Docker Agent discovers skills
  • How to configure the skills: field in agent.yaml
  • What paths to copy skills to

This leaves the Docker Agent installation instructions incomplete and unusable.

Suggested fix

Either:

  1. Create the missing /ai/docker-agent/features/skills/ documentation page with the discovery paths and configuration details, or
  2. Remove or rewrite the Docker Agent section in install.md to not reference non-existent documentation, providing the necessary information inline or removing the Docker Agent installation method if it's not yet supported

The example configuration in install.md also shows a skills: field that doesn't appear in any Docker Agent documentation examples, suggesting this feature may not be implemented or documented yet.


Found by nightly documentation quality scanner

Activity

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