fix(skills): move computer-use skill into the autonomous-ai-agents category

skills/computer-use/SKILL.md sat at the root of the bundled skills
tree as an uncategorized single-skill directory. Move it to
skills/autonomous-ai-agents/computer-use/ alongside claude-code,
codex, opencode, and hermes-agent.

- git mv skills/computer-use -> skills/autonomous-ai-agents/computer-use
  (history preserved)
- root-level-skill docstring examples (commands.py,
  generate-skill-docs.py) now use a generic placeholder instead of
  naming a specific skill, since categorizing root-level skills is
  ongoing
- docs: move the bundled page to autonomous-ai-agents-computer-use,
  update sidebars.ts, skills-catalog.md, and the two skill-path
  references in features/computer-use.md

E2E validated: fresh sync_skills() copies to the new nested path;
existing installs with the old flat copy keep it untouched (manifest
name-keyed, hash unchanged -> skipped, no duplicate);
_get_category_from_path resolves 'autonomous-ai-agents'; docusaurus
build green; 396 targeted tests pass.
This commit is contained in:
Teknium 2026-07-23 20:06:15 -07:00
parent a56845bd8c
commit b718725121
7 changed files with 8 additions and 20 deletions

View File

@ -967,7 +967,8 @@ def discord_skill_commands_by_category(
Skills whose directory is nested at least 2 levels under a scan root
(e.g. ``creative/ascii-art/SKILL.md``) are grouped by their top-level
category. Root-level skills (e.g. ``computer-use/SKILL.md``) are returned as
category. Root-level skills (e.g. ``some-skill/SKILL.md`` directly under a
scan root) are returned as
*uncategorized*.
Scan roots include the local ``SKILLS_DIR`` **and** any configured

View File

@ -27,15 +27,10 @@ If a skill is missing from this list but present in the repo, the catalog is reg
|-------|-------------|------|
| [`claude-code`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code) | Delegate coding to Claude Code CLI (features, PRs). | `autonomous-ai-agents/claude-code` |
| [`codex`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex) | Delegate coding to OpenAI Codex CLI (features, PRs). | `autonomous-ai-agents/codex` |
| [`computer-use`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use) | Drive the user's desktop in the background — clicking, typing, scrolling, dragging — without stealing the cursor, keyboard focus, or switching virtual desktops / Spaces. Cross-platform: macOS, Windows, Linux. Works with any tool-capable... | `autonomous-ai-agents/computer-use` |
| [`hermes-agent`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent) | Use, configure, theme, extend, and orchestrate Hermes Agent. | `autonomous-ai-agents/hermes-agent` |
| [`opencode`](/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode) | Delegate coding to OpenCode CLI (features, PR review). | `autonomous-ai-agents/opencode` |
## computer-use
| Skill | Description | Path |
|-------|-------------|------|
| [`computer-use`](/docs/user-guide/skills/bundled/computer-use/computer-use-computer-use) | Drive the user's desktop in the background — clicking, typing, scrolling, dragging — without stealing the cursor, keyboard focus, or switching virtual desktops / Spaces. Cross-platform: macOS, Windows, Linux. Works with any tool-capable... | `computer-use` |
## creative
| Skill | Description | Path |

View File

@ -130,7 +130,7 @@ halo).
## Going deeper — the cua-driver skill pack
Hermes intentionally keeps its skill (`skills/computer-use/SKILL.md`)
Hermes intentionally keeps its skill (`skills/autonomous-ai-agents/computer-use/SKILL.md`)
focused on the Hermes-side `computer_use` action vocabulary — the
single source of truth the agent loads. For the deeper material —
platform-specific deep dives, recording semantics, browser page
@ -449,7 +449,7 @@ autostart pattern — see
## See also
- **Hermes-side skill**`skills/computer-use/SKILL.md` — teaches the
- **Hermes-side skill**`skills/autonomous-ai-agents/computer-use/SKILL.md` — teaches the
Hermes `computer_use` action vocabulary; this is what the agent loads.
- **cua-driver skill pack** — for platform-specific deep dives
(macOS no-foreground contract, Windows UIA + Session 0, Linux AT-SPI

View File

@ -19,7 +19,7 @@ whenever the `computer_use` tool is available.
| | |
|---|---|
| Source | Bundled (installed by default) |
| Path | `skills/computer-use` |
| Path | `skills/autonomous-ai-agents/computer-use` |
| Version | `2.0.0` |
| Platforms | macos, windows, linux |
| Tags | `computer-use`, `desktop`, `automation`, `gui`, `cross-platform` |

View File

@ -284,7 +284,7 @@ def derive_skill_meta(skill_path: Path, source_dir: Path, source_kind: str) -> d
rel = skill_path.parent.relative_to(source_dir)
parts = rel.parts
if len(parts) == 1:
# Top-level skill (e.g. skills/computer-use/SKILL.md) -- rare
# Top-level skill (e.g. skills/<name>/SKILL.md with no category) -- rare
category = parts[0]
sub = None
slug = parts[0]

View File

@ -154,19 +154,11 @@ const sidebars: SidebarsConfig = {
items: [
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent',
'user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode',
],
},
{
type: 'category',
label: 'computer-use',
key: 'skills-bundled-computer-use',
collapsed: true,
items: [
'user-guide/skills/bundled/computer-use/computer-use-computer-use',
],
},
{
type: 'category',
label: 'creative',