skills

namespace	aiwg
name	skills
platforms	["all"]
description	Manage the AIWG skills registry by listing, searching, inspecting, installing, and publishing skills

Skills Registry

You manage the AIWG skills registry — listing installed skills, searching the registry, fetching skill details, installing skills, and publishing skills to ClaWHub/OpenClaw.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "what skills do I have" → list
• "find a skill for git" → search git
• "how does the deploy-gen skill work" → info deploy-gen
• "get the roko-voice skill" → install roko-voice
• "share this skill" → publish

Trigger Patterns Reference

Pattern	Example	Action
List installed	"what skills are installed?"	Run aiwg skills list
Search registry	"search for skills related to voice"	Run aiwg skills search voice
Skill details	"tell me about the mention-wire skill"	Run aiwg skills info mention-wire
Install skill	"install the commit-and-push skill"	Run aiwg skills install commit-and-push
Publish skill	"publish this skill to the registry"	Run aiwg skills publish <path>

Behavior

When triggered:

1. Identify the subcommand:

   • Is the user listing, searching, inspecting, installing, or publishing?
   • Is a skill ID or search query mentioned?

2. Run the appropriate command:

   # List locally installed skills
   aiwg skills list
   
   # Search the registry
   aiwg skills search <query>
   
   # Show details for a specific skill
   aiwg skills info <skill-id>
   
   # Install a skill from the registry
   aiwg skills install <skill-id>
   
   # Publish a skill to the registry
   aiwg skills publish <skill-path>
   
   # Machine-readable output
   aiwg skills list --json
   aiwg skills search <query> --json
   

3. Report the result — confirm what was found, installed, or published.

Examples

Example 1: List installed skills

User: "What skills are installed?"

Extraction: List subcommand

Action:

aiwg skills list

Response: "47 skills installed. Categories: devkit (8), workspace (5), voice (6), mention (5), soul (7), deploy (4), other (12). Run aiwg skills info <id> for details."

Example 2: Search the registry

User: "Search for skills related to git"

Extraction: Search subcommand, query = git

Action:

aiwg skills search git

Response: "4 registry results for 'git': commit-and-push (installed), git-flow, git-blame-analysis, repo-health-check. Run aiwg skills install <id> to add any."

Example 3: Skill details

User: "How does the deploy-gen skill work?"

Extraction: Info subcommand, skill-id = deploy-gen

Action:

aiwg skills info deploy-gen

Response: "deploy-gen: Generates deployment plans and runbooks from SDLC artifacts. Triggers on 'generate deployment plan', 'create runbook', 'deploy prep'. Allowed tools: Read, Write, Bash. Handler: src/cli/handlers/deploy-gen.ts."

Example 4: Install a skill

User: "Install the repo-health-check skill"

Extraction: Install subcommand, skill-id = repo-health-check

Action:

aiwg skills install repo-health-check

Response: "Installed repo-health-check v1.2.0 to agentic/code/addons/aiwg-utils/skills/repo-health-check/. Triggers: 'repo health', 'check repository health', 'audit repo'."

Example 5: Publish a skill

User: "Publish the skill at ./my-skills/code-review to the registry"

Extraction: Publish subcommand, path = ./my-skills/code-review

Action:

aiwg skills publish ./my-skills/code-review

Response: "Published code-review v1.0.0 to the skills registry. Available as aiwg skills install code-review."

Clarification Prompts

If the user's intent is ambiguous:

• "Are you looking for a skill that's already installed, or searching the registry for one to add?"
• "Which skill ID do you want to install? I can run aiwg skills search <topic> to find candidates."

References

• @$AIWG_ROOT/src/cli/handlers/subcommands.ts — Skills subcommand handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference (skills section)
• @$AIWG_ROOT/agentic/code/addons/aiwg-utils/skills/ — Installed skills directory