NAME
skills - private built-in command wrapper for Developer Dashboard
SYNOPSIS
dashboard skills ...
DESCRIPTION
This private helper is staged under ~/.developer-dashboard/cli/dd/ so the public dashboard entrypoint can stay a thin switchboard.
PURPOSE
This staged helper exposes dashboard skills, the command family that installs, updates, lists, enables, disables, and uninstalls skills while also serving as the private handoff target for dotted skill command execution.
WHY IT EXISTS
It exists because skill lifecycle management is a built-in feature, but the wrapper should stage a command and leave Git/layout logic to the skill manager and skill command dispatch to the dedicated runtime module.
WHEN TO USE
Use this file when changing the dashboard skills CLI verbs or the dotted-command handoff into the skill runtime.
HOW TO USE
Users run dashboard skills install, enable, disable, list, usage, or uninstall. The singular dashboard skill command is accepted as an alias for the same management family. The staged helper forwards those lifecycle requests into the private runtime, which loads the skill manager and performs the requested action. Install accepts one or more Git URLs, direct local checked-out skill directories, shorthand source names, or no source at all when the home root ~/.developer-dashboard/ddfile already lists registered skills to reinstall. Install shows a progress rundown before long work starts and defaults to a before/after version table; -o json keeps the raw payload for scripts. The public dotted form dashboard <repo-name>.<command> also lands here through an internal action so installed skill commands keep one private helper surface.
WHAT USES IT
It is used by developers managing installed skills, by dotted skill command dispatch, by skill lifecycle tests, and by documentation that explains the isolated skill runtime.
EXAMPLES
Example 1:
dashboard skills install git@github.com:user/example-skill.git
dashboard skills install /absolute/path/to/example-skill
dashboard skills install browser foo/bar git@github.com:user/example-skill.git
dashboard skill install browser
Install or reinstall one or more isolated skills into their runtime roots from Git, shorthand sources, or qualified local checkouts. Direct local installs use rsync when it is available and the built-in Perl tree-copy fallback when it is not. Each explicit source is remembered in the home root ~/.developer-dashboard/ddfile without duplicates.
Example 2:
dashboard skills install
Reinstall every skill source listed in the home root ~/.developer-dashboard/ddfile.
Example 3:
dashboard skills list
Inspect installed skill metadata. The default output is a readable table, and -o json returns structured output.
Example 4:
dashboard example-skill.hello
Run an installed skill command through the public dotted route, which the switchboard forwards into this staged helper.
Example 5:
~/.developer-dashboard/cli/dd/skills --help
Inspect the staged helper directly after dashboard init or helper extraction has populated the home runtime.
Example 6:
prove -lv t/05-cli-smoke.t t/19-skill-system.t
Rerun the focused staged-helper and thin-loader tests after changing helper dispatch behavior.
Example 7:
prove -lr t
Verify that the helper still behaves correctly inside the complete repository suite.