feat(cli): rename skills → skill (plural alias kept)

README.md

@@ -94,8 +94,8 @@ clients:
 | `allagents plugin install <spec>` | Install a plugin |
 | `allagents plugin uninstall <spec>` | Remove a plugin |
 | `allagents plugin list` | List available plugins |
-| `allagents skills add <name>` | Add a skill from a repo |
-| `allagents skills list` | List skills and status |
+| `allagents skill add <name>` | Add a skill from a repo (plural `skills` alias supported) |
+| `allagents skill list` | List skills and status |
 | `allagents mcp add <name> <commandOrUrl>` | Add an MCP server and sync to clients |
 | `allagents mcp list` | List workspace MCP servers |
 | `allagents workspace status` | Show workspace state |

docs/src/content/docs/docs/getting-started/quick-start.mdx

@@ -43,13 +43,13 @@ allagents update
 Install a specific skill from a GitHub repo without adding the full plugin:
 
 ```bash
-allagents skills add reddit --from ReScienceLab/opc-skills
+allagents skill add reddit --from ReScienceLab/opc-skills
 ```
 
 Or pass a GitHub URL directly:
 
 ```bash
-allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
+allagents skill add https://github.com/owner/repo/tree/main/skills/my-skill
 ```
 
 ## Install User-Scoped Plugins

docs/src/content/docs/docs/guides/plugins.mdx

@@ -62,13 +62,13 @@ You can add a specific skill from a GitHub repo without installing the full plug
 
 ```bash
 # Add a skill by name, specifying the plugin source
-allagents skills add reddit --from ReScienceLab/opc-skills
+allagents skill add reddit --from ReScienceLab/opc-skills
 
 # Or pass a GitHub URL directly
-allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
+allagents skill add https://github.com/owner/repo/tree/main/skills/my-skill
 ```
 
-This installs the plugin and enables only the specified skill. See the [CLI reference](/docs/reference/cli/#plugin-skills-add) for all source formats.
+This installs the plugin and enables only the specified skill. See the [CLI reference](/docs/reference/cli/#skill-add) for all source formats.
 
 ## Disabling Individual Skills
 

docs/src/content/docs/docs/reference/cli.mdx

@@ -104,9 +104,9 @@ allagents plugin marketplace add <source> [--name <name>] [--branch <branch>]
 allagents plugin marketplace list
 allagents plugin marketplace remove <name>
 allagents plugin marketplace update [name]
-allagents plugin skills list [--scope <scope>]
-allagents plugin skills remove <skill> [--plugin <plugin>] [--scope <scope>]
-allagents plugin skills add <skill> [--from <source>] [--plugin <plugin>] [--scope <scope>]
+allagents skill list [--scope <scope>]
+allagents skill remove <skill> [--plugin <plugin>] [--scope <scope>]
+allagents skill add <skill> [--from <source>] [--plugin <plugin>] [--scope <scope>]
 ```
 
 ### plugin install
@@ -126,17 +126,17 @@ Only enable specific skills from the plugin. Can be specified multiple times:
 allagents plugin install superpowers@marketplace --skill brainstorming --skill tdd
 ```
 
-When used, all other skills from the plugin are implicitly disabled. Skills can be added later with `plugin skills add`.
+When used, all other skills from the plugin are implicitly disabled. Skills can be added later with `skill add`.
 
-### plugin skills list
+### skill list
 
 List all skills from installed plugins with their enabled/disabled status.
 
 | Flag | Description |
 |------|-------------|
 | `-s, --scope <scope>` | Scope: `project` (default) or `user` |
 
-### plugin skills remove
+### skill remove
 
 Disable a skill, preventing it from being synced to the workspace.
 
@@ -147,7 +147,7 @@ Disable a skill, preventing it from being synced to the workspace.
 
 After disabling, the skill is added to `disabledSkills` in workspace.yaml and sync is run to remove it.
 
-### plugin skills add
+### skill add
 
 Add a skill from a plugin, or re-enable a previously disabled skill. The `<skill>` argument can be a skill name or a GitHub URL pointing to a skill.
 
@@ -163,10 +163,10 @@ Use `--from` to specify the plugin source when the skill isn't already installed
 
 ```bash
 # Add a specific skill from a GitHub repo
-allagents skills add reddit --from ReScienceLab/opc-skills
+allagents skill add reddit --from ReScienceLab/opc-skills
 
 # Or pass a GitHub URL directly — the skill name is extracted from the URL path
-allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
+allagents skill add https://github.com/owner/repo/tree/main/skills/my-skill
 ```
 
 **Source formats for `--from`:**
@@ -177,14 +177,15 @@ allagents skills add https://github.com/owner/repo/tree/main/skills/my-skill
 #### Re-enabling a disabled skill
 
 ```bash
-allagents skills add brainstorming
-allagents skills add brainstorming --plugin superpowers
+allagents skill add brainstorming
+allagents skill add brainstorming --plugin superpowers
 ```
 
 After enabling, the skill is removed from `disabledSkills` and sync is run to restore it.
 
 :::tip
-`allagents skills add` is a shorthand for `allagents plugin skills add`.
+`allagents skill ...` is the canonical singular form. The plural alias
+`allagents skills ...` is also accepted and produces identical output.
 :::
 
 ## MCP Commands

src/cli/agent-help.ts

@@ -13,6 +13,11 @@ import {
   pluginUninstallMeta,
 } from './metadata/plugin.js';
 import { updateMeta } from './metadata/self.js';
+import {
+  skillsListMeta,
+  skillsAddMeta,
+  skillsRemoveMeta,
+} from './metadata/plugin-skills.js';
 
 const allCommands: AgentCommandMeta[] = [
   initMeta,
@@ -27,6 +32,9 @@ const allCommands: AgentCommandMeta[] = [
   marketplaceBrowseMeta,
   pluginListMeta,
   pluginValidateMeta,
+  skillsListMeta,
+  skillsAddMeta,
+  skillsRemoveMeta,
   updateMeta,
 ];
 
@@ -59,8 +67,15 @@ function formatForAgent(meta: AgentCommandMeta) {
 }
 
 export function printAgentHelp(args: string[], version: string): void {
-  // Determine which command is being asked about by looking at remaining args
-  const commandPath = args.filter(a => !a.startsWith('-')).join(' ');
+  // Determine which command is being asked about by looking at remaining args.
+  // `skills` is a permanent alias for the canonical singular `skill`; normalize
+  // the lookup key so `--agent-help "skills list"` resolves to the `skill list`
+  // meta.
+  const positional = args.filter(a => !a.startsWith('-'));
+  const normalized = positional[0] === 'skills'
+    ? ['skill', ...positional.slice(1)]
+    : positional;
+  const commandPath = normalized.join(' ');
 
   if (!commandPath) {
     // Full tree