Agent skills rely on repository-level symlinks and break when installed via gh skill #1932

The agent skills under es-toolkit-plugin/skills are not fully portable when installed with tools that distribute each skill as a standalone directory. (Using official Github CLI)

Each skill contains a docs symbolic link pointing outside the skill directory:

es-toolkit-plugin/skills/guide/docs     -> ../../../docs
es-toolkit-plugin/skills/migrate/docs   -> ../../../docs
es-toolkit-plugin/skills/recommend/docs -> ../../../docs

When an installer copies only the selected skill directory, the repository-level docs directory is not included. The resulting installed skill therefore contains a dangling symlink or a symlink whose target does not exist.

Reproduction

Using GitHub CLI 2.96.0:

gh skill install toss/es-toolkit

After installation, inspect one of the installed skills:

ls -la <installed-skill-directory>

The docs entry is still a symbolic link to ../../../docs.

However, the target directory was not installed, so references such as docs/reference/**/*.md cannot be accessed by the skill.