Create Custom Skill#

You are helping the user create a new custom skill for khy OS.

Steps#

1. Ask the user for:
   • Skill name (lowercase, hyphenated, e.g., "analyze-logs")
   • Description (what the skill does)
   • Trigger command (e.g., "/analyze-logs")
   • Whether it needs a custom handler.js or just a prompt template

1. Create the skill directory at ~/.khy/skills/<skill-name>/:

   <skill-name>/
     manifest.json    — Skill metadata
     prompt.md        — Prompt template (always created)
     handler.js       — Custom logic (optional, only if requested)

1. Generate manifest.json:

   {
     "name": "<skill-name>",
     "description": "<description>",
     "user_invocable": true,
     "trigger": "/<trigger>",
     "aliases": [],
     "category": "custom",
     "tags": ["<relevant>", "<tags>"]
   }

1. Generate prompt.md:
   • Clear title and purpose
   • Step-by-step instructions for the AI
   • Any constraints or important notes
   • Tailored to the user's described use case

1. If handler.js is requested, generate:

   module.exports = {
     async execute(args, context) {
       // Custom skill logic
       return { result: 'Skill executed successfully' };
     }
   };

1. After creating, tell the user:
   • The skill is immediately available (no restart needed after cache invalidation)
   • They can trigger it with the configured command
   • They can edit the files to customize behavior

Important#

• Skills are stored per-user in ~/.khy/skills/ (survive updates)
• Project-level skills go in .khy/skills/ (project-specific)
• Manifest.json is required; prompt.md is the default execution method
• handler.js overrides prompt.md when both exist