@octo-cyber/ai 0.5.0 → 0.5.2

package/dist/skill/services/skill-registry.service.d.ts

@@ -0,0 +1,60 @@
+import { OctoSkill } from '../entities/octo-skill.entity.js';
+import type { SkillSourceType } from '../types.js';
+/**
+ * Manages OctoSkill CRUD and orchestrates skill (re)generation.
+ */
+export declare class SkillRegistryService {
+    private repo;
+    private readonly logger;
+    private readonly generator;
+    initialize(): void;
+    /**
+     * Regenerate skills for all modules from RouteRegistry.
+     * Skips skills that have been manually edited (isEdited=true).
+     */
+    regenerateSkills(baseUrl: string, apiKey?: string): Promise<{
+        created: string[];
+        updated: string[];
+        skipped: string[];
+    }>;
+    /**
+     * List all skills with optional filter.
+     */
+    listSkills(filter?: {
+        isEnabled?: boolean;
+        sourceType?: SkillSourceType;
+    }): Promise<OctoSkill[]>;
+    /**
+     * Get a single skill by ID.
+     */
+    getSkill(id: string): Promise<OctoSkill | null>;
+    /**
+     * Create a custom skill.
+     */
+    createCustomSkill(data: {
+        name: string;
+        description: string;
+        content: string;
+    }): Promise<OctoSkill>;
+    /**
+     * Update skill content (marks as edited to prevent auto-overwrite).
+     */
+    updateSkillContent(id: string, content: string): Promise<OctoSkill>;
+    /**
+     * Update skill metadata (name, description).
+     */
+    updateSkill(id: string, data: Partial<Pick<OctoSkill, 'name' | 'description' | 'content'>>): Promise<OctoSkill>;
+    /**
+     * Toggle skill enabled state.
+     */
+    toggleSkill(id: string): Promise<OctoSkill>;
+    /**
+     * Delete a skill.
+     */
+    deleteSkill(id: string): Promise<void>;
+    /**
+     * Update install targets for a skill (called by installer).
+     */
+    updateInstallTargets(id: string, targets: string[]): Promise<void>;
+}
+//# sourceMappingURL=skill-registry.service.d.ts.map

package/dist/skill/services/skill-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.service.d.ts","sourceRoot":"","sources":["../../../src/skill/services/skill-registry.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAElE,UAAU,IAAI,IAAI;IAKlB;;;OAGG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAyCvE;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOxB;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIrD;;OAEG;IACG,iBAAiB,CAAC,IAAI,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,SAAS,CAAC;IAYtB;;OAEG;IACG,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC;IAQrB;;OAEG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC,GACjE,OAAO,CAAC,SAAS,CAAC;IAYrB;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOjD;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,oBAAoB,CACxB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC;CAOjB"}

package/dist/skill/services/skill-registry.service.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillRegistryService = void 0;
+const core_1 = require("@octo-cyber/core");
+const octo_skill_entity_js_1 = require("../entities/octo-skill.entity.js");
+const skill_generator_service_js_1 = require("./skill-generator.service.js");
+/**
+ * Manages OctoSkill CRUD and orchestrates skill (re)generation.
+ */
+class SkillRegistryService {
+    repo;
+    logger = core_1.Container.get(core_1.LoggerService);
+    generator = core_1.Container.get(skill_generator_service_js_1.SkillGeneratorService);
+    initialize() {
+        const db = core_1.Container.get(core_1.DatabaseService);
+        this.repo = db.getRepository(octo_skill_entity_js_1.OctoSkill);
+    }
+    /**
+     * Regenerate skills for all modules from RouteRegistry.
+     * Skips skills that have been manually edited (isEdited=true).
+     */
+    async regenerateSkills(baseUrl, apiKey) {
+        const results = this.generator.generateAll(baseUrl, apiKey);
+        const created = [];
+        const updated = [];
+        const skipped = [];
+        for (const result of results) {
+            const existing = await this.repo.findOneBy({ name: result.name });
+            if (existing) {
+                if (existing.isEdited) {
+                    skipped.push(result.name);
+                    continue;
+                }
+                existing.description = result.description;
+                existing.content = result.content;
+                existing.version = result.version;
+                await this.repo.save(existing);
+                updated.push(result.name);
+            }
+            else {
+                const skill = this.repo.create({
+                    name: result.name,
+                    description: result.description,
+                    sourceModule: result.sourceModule,
+                    sourceType: 'module',
+                    content: result.content,
+                    version: result.version,
+                    isEnabled: true,
+                    isEdited: false,
+                });
+                await this.repo.save(skill);
+                created.push(result.name);
+            }
+        }
+        this.logger.info(`Skill regeneration: ${created.length} created, ${updated.length} updated, ${skipped.length} skipped`);
+        return { created, updated, skipped };
+    }
+    /**
+     * List all skills with optional filter.
+     */
+    async listSkills(filter) {
+        const where = {};
+        if (filter?.isEnabled !== undefined)
+            where.isEnabled = filter.isEnabled;
+        if (filter?.sourceType)
+            where.sourceType = filter.sourceType;
+        return this.repo.find({ where, order: { name: 'ASC' } });
+    }
+    /**
+     * Get a single skill by ID.
+     */
+    async getSkill(id) {
+        return this.repo.findOneBy({ id });
+    }
+    /**
+     * Create a custom skill.
+     */
+    async createCustomSkill(data) {
+        const skill = this.repo.create({
+            ...data,
+            sourceModule: 'custom',
+            sourceType: 'custom',
+            version: '1.0',
+            isEnabled: true,
+            isEdited: true,
+        });
+        return this.repo.save(skill);
+    }
+    /**
+     * Update skill content (marks as edited to prevent auto-overwrite).
+     */
+    async updateSkillContent(id, content) {
+        const skill = await this.repo.findOneBy({ id });
+        if (!skill)
+            throw new Error(`Skill not found: ${id}`);
+        skill.content = content;
+        skill.isEdited = true;
+        return this.repo.save(skill);
+    }
+    /**
+     * Update skill metadata (name, description).
+     */
+    async updateSkill(id, data) {
+        const skill = await this.repo.findOneBy({ id });
+        if (!skill)
+            throw new Error(`Skill not found: ${id}`);
+        if (data.name !== undefined)
+            skill.name = data.name;
+        if (data.description !== undefined)
+            skill.description = data.description;
+        if (data.content !== undefined) {
+            skill.content = data.content;
+            skill.isEdited = true;
+        }
+        return this.repo.save(skill);
+    }
+    /**
+     * Toggle skill enabled state.
+     */
+    async toggleSkill(id) {
+        const skill = await this.repo.findOneBy({ id });
+        if (!skill)
+            throw new Error(`Skill not found: ${id}`);
+        skill.isEnabled = !skill.isEnabled;
+        return this.repo.save(skill);
+    }
+    /**
+     * Delete a skill.
+     */
+    async deleteSkill(id) {
+        await this.repo.delete(id);
+    }
+    /**
+     * Update install targets for a skill (called by installer).
+     */
+    async updateInstallTargets(id, targets) {
+        const skill = await this.repo.findOneBy({ id });
+        if (!skill)
+            throw new Error(`Skill not found: ${id}`);
+        skill.installTargets = targets.length > 0 ? JSON.stringify(targets) : null;
+        skill.lastInstalledAt = new Date();
+        await this.repo.save(skill);
+    }
+}
+exports.SkillRegistryService = SkillRegistryService;
+core_1.Container.register(SkillRegistryService);
+//# sourceMappingURL=skill-registry.service.js.map

package/dist/skill/services/skill-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-registry.service.js","sourceRoot":"","sources":["../../../src/skill/services/skill-registry.service.ts"],"names":[],"mappings":"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"}

package/dist/skill/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Skill-related type definitions for the SKILL.md generation system.
+ */
+/** Supported AI tool targets for skill installation. */
+export type SkillTarget = 'claude' | 'cursor' | 'codex';
+/** Information about an AI tool installation target. */
+export interface SkillTargetInfo {
+    id: SkillTarget;
+    name: string;
+    /** Base directory for skills (e.g. ~/.claude/skills/) */
+    skillsDir: string;
+    /** How to detect if the tool is installed */
+    detectDir: string;
+    isInstalled: boolean;
+}
+/** Source type for a skill. */
+export type SkillSourceType = 'module' | 'custom';
+/** Parameters for generating a skill from a module. */
+export interface SkillGenerateParams {
+    /** Module name (e.g. 'auth', 'erp'). */
+    module: string;
+    /** Base URL of the Octo server (e.g. 'http://localhost:9988'). */
+    baseUrl: string;
+    /** API Key to embed in the skill (full key string). */
+    apiKey?: string;
+}
+/** Result of skill generation. */
+export interface SkillGenerateResult {
+    name: string;
+    description: string;
+    content: string;
+    sourceModule: string;
+    version: string;
+}
+/** Endpoint info extracted from RouteRegistry for skill generation. */
+export interface EndpointInfo {
+    method: string;
+    path: string;
+    summary: string;
+    permission?: string;
+    controller: string;
+    controllerName?: string;
+    tags?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/skill/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAExD,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/skill/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Skill-related type definitions for the SKILL.md generation system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/skill/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skill/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octo-cyber/ai",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Octo AI module — Agent + Capability + SyncBridge + client registration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,9 +22,9 @@
     }
   },
   "dependencies": {
-    "@octo-cyber/core": "^0.5.0",
-    "@octo-cyber/task": "^0.5.0",
-    "@octo-cyber/auth": "^0.5.0"
+    "@octo-cyber/core": "^0.5.3",
+    "@octo-cyber/auth": "^0.5.4",
+    "@octo-cyber/task": "^0.5.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/web/components/SkillCard.tsx

@@ -0,0 +1,139 @@
+'use client'
+
+import { useTranslations } from 'next-intl'
+import {
+  Download,
+  Edit,
+  MoreHorizontal,
+  Trash2,
+  ToggleLeft,
+  ToggleRight,
+  CheckCircle2,
+} from 'lucide-react'
+
+import { Badge } from '@octo-cyber/ui/components/ui/badge'
+import { Button } from '@octo-cyber/ui/components/ui/button'
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@octo-cyber/ui/components/ui/card'
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger,
+} from '@octo-cyber/ui/components/ui/dropdown-menu'
+
+import type { SkillInfo, SkillTargetInfo } from '../services/skill-service'
+
+interface SkillCardProps {
+  skill: SkillInfo
+  targets: SkillTargetInfo[]
+  onInstall: () => void
+  onEdit: () => void
+  onToggle: () => void
+  onDelete: () => void
+}
+
+export default function SkillCard({
+  skill,
+  targets,
+  onInstall,
+  onEdit,
+  onToggle,
+  onDelete,
+}: SkillCardProps) {
+  const t = useTranslations('aiSkills')
+
+  const installedTargets = skill.installedTargets ?? []
+
+  return (
+    <Card className="flex flex-col">
+      <CardHeader className="flex-row items-start justify-between space-y-0 pb-2">
+        <div className="space-y-1">
+          <CardTitle className="text-base font-semibold">
+            {skill.name}
+          </CardTitle>
+          <CardDescription className="line-clamp-2 text-sm">
+            {skill.description}
+          </CardDescription>
+        </div>
+        <DropdownMenu>
+          <DropdownMenuTrigger asChild>
+            <Button variant="ghost" size="icon" className="h-8 w-8">
+              <MoreHorizontal className="h-4 w-4" />
+            </Button>
+          </DropdownMenuTrigger>
+          <DropdownMenuContent align="end">
+            <DropdownMenuItem onClick={onEdit}>
+              <Edit className="mr-2 h-4 w-4" />
+              {t('actions.edit')}
+            </DropdownMenuItem>
+            <DropdownMenuItem onClick={onToggle}>
+              {skill.isEnabled ? (
+                <ToggleLeft className="mr-2 h-4 w-4" />
+              ) : (
+                <ToggleRight className="mr-2 h-4 w-4" />
+              )}
+              {skill.isEnabled ? t('actions.disable') : t('actions.enable')}
+            </DropdownMenuItem>
+            <DropdownMenuSeparator />
+            <DropdownMenuItem onClick={onDelete} className="text-destructive">
+              <Trash2 className="mr-2 h-4 w-4" />
+              {t('actions.delete')}
+            </DropdownMenuItem>
+          </DropdownMenuContent>
+        </DropdownMenu>
+      </CardHeader>
+
+      <CardContent className="flex flex-1 flex-col justify-between gap-3">
+        {/* Meta info */}
+        <div className="flex flex-wrap items-center gap-2 text-xs text-muted-foreground">
+          <Badge variant={skill.isEnabled ? 'default' : 'secondary'} className="text-xs">
+            {skill.isEnabled ? t('status.enabled') : t('status.disabled')}
+          </Badge>
+          <span>{t('meta.source')}: {skill.sourceModule}</span>
+          <span>v{skill.version}</span>
+          {skill.isEdited && (
+            <Badge variant="outline" className="text-xs">
+              {t('meta.edited')}
+            </Badge>
+          )}
+        </div>
+
+        {/* Install status */}
+        <div className="flex flex-wrap items-center gap-1.5">
+          {targets.filter((tgt) => tgt.isInstalled).map((tgt) => {
+            const isInstalled = installedTargets.includes(tgt.id)
+            return (
+              <Badge
+                key={tgt.id}
+                variant={isInstalled ? 'default' : 'outline'}
+                className="text-xs"
+              >
+                {isInstalled && <CheckCircle2 className="mr-1 h-3 w-3" />}
+                {tgt.name}
+              </Badge>
+            )
+          })}
+        </div>
+
+        {/* Install button */}
+        <Button
+          variant="outline"
+          size="sm"
+          className="w-full"
+          onClick={onInstall}
+          disabled={!skill.isEnabled}
+        >
+          <Download className="mr-2 h-4 w-4" />
+          {t('actions.install')}
+        </Button>
+      </CardContent>
+    </Card>
+  )
+}

package/web/components/SkillEditorDialog.tsx

@@ -0,0 +1,77 @@
+'use client'
+
+import { useState } from 'react'
+import { useTranslations } from 'next-intl'
+import { Loader2 } from 'lucide-react'
+
+import { Button } from '@octo-cyber/ui/components/ui/button'
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@octo-cyber/ui/components/ui/dialog'
+import { Textarea } from '@octo-cyber/ui/components/ui/textarea'
+
+import type { SkillInfo } from '../services/skill-service'
+
+interface SkillEditorDialogProps {
+  skill: SkillInfo
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  onSave: (id: string, content: string) => Promise<void>
+}
+
+export default function SkillEditorDialog({
+  skill,
+  open,
+  onOpenChange,
+  onSave,
+}: SkillEditorDialogProps) {
+  const t = useTranslations('aiSkills')
+  const tc = useTranslations('common')
+
+  const [content, setContent] = useState(skill.content)
+  const [saving, setSaving] = useState(false)
+
+  const handleSave = async () => {
+    setSaving(true)
+    try {
+      await onSave(skill.id, content)
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-3xl max-h-[80vh]">
+        <DialogHeader>
+          <DialogTitle>{t('editor.title', { name: skill.name })}</DialogTitle>
+          <DialogDescription>
+            {t('editor.description')}
+          </DialogDescription>
+        </DialogHeader>
+
+        <Textarea
+          value={content}
+          onChange={(e) => setContent(e.target.value)}
+          className="min-h-[400px] font-mono text-sm"
+          placeholder="SKILL.md content..."
+        />
+
+        <DialogFooter>
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            {tc('cancel')}
+          </Button>
+          <Button onClick={handleSave} disabled={saving}>
+            {saving && <Loader2 className="mr-2 h-4 w-4 animate-spin" />}
+            {tc('save')}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  )
+}

package/web/components/SkillInstallDialog.tsx

@@ -0,0 +1,134 @@
+'use client'
+
+import { useState, useCallback } from 'react'
+import { useTranslations } from 'next-intl'
+import { toast } from 'sonner'
+import { CheckCircle2, Loader2 } from 'lucide-react'
+
+import { Button } from '@octo-cyber/ui/components/ui/button'
+import { Checkbox } from '@octo-cyber/ui/components/ui/checkbox'
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from '@octo-cyber/ui/components/ui/dialog'
+import { Label } from '@octo-cyber/ui/components/ui/label'
+
+import { skillService } from '../services/skill-service'
+import type { SkillInfo, SkillTargetInfo } from '../services/skill-service'
+
+interface SkillInstallDialogProps {
+  skill: SkillInfo
+  targets: SkillTargetInfo[]
+  open: boolean
+  onOpenChange: (open: boolean) => void
+  onDone: () => void
+}
+
+export default function SkillInstallDialog({
+  skill,
+  targets,
+  open,
+  onOpenChange,
+  onDone,
+}: SkillInstallDialogProps) {
+  const t = useTranslations('aiSkills')
+  const tc = useTranslations('common')
+
+  const availableTargets = targets.filter((tgt) => tgt.isInstalled)
+  const [selected, setSelected] = useState<string[]>(
+    skill.installedTargets ?? [],
+  )
+  const [installing, setInstalling] = useState(false)
+
+  const toggleTarget = useCallback((id: string) => {
+    setSelected((prev) =>
+      prev.includes(id) ? prev.filter((x) => x !== id) : [...prev, id],
+    )
+  }, [])
+
+  const handleInstall = useCallback(async () => {
+    if (selected.length === 0) return
+    setInstalling(true)
+    try {
+      const result = await skillService.install(skill.id, selected)
+      if (result.failed.length > 0) {
+        toast.error(t('toast.installPartial', {
+          failed: result.failed.map((f) => f.target).join(', '),
+        }))
+      } else {
+        toast.success(t('toast.installed', {
+          targets: selected.join(', '),
+        }))
+      }
+      if (result.apiKeyCreated) {
+        toast.success(t('toast.apiKeyCreated'))
+      }
+      onDone()
+    } catch {
+      toast.error(t('toast.installFailed'))
+    } finally {
+      setInstalling(false)
+    }
+  }, [skill.id, selected, t, onDone])
+
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent className="sm:max-w-md">
+        <DialogHeader>
+          <DialogTitle>{t('installDialog.title')}</DialogTitle>
+          <DialogDescription>
+            {t('installDialog.description', { name: skill.name })}
+          </DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-3 py-4">
+          {availableTargets.length === 0 ? (
+            <p className="text-sm text-muted-foreground">
+              {t('installDialog.noTargets')}
+            </p>
+          ) : (
+            availableTargets.map((tgt) => {
+              const isAlreadyInstalled = (skill.installedTargets ?? []).includes(tgt.id)
+              return (
+                <div key={tgt.id} className="flex items-center space-x-3">
+                  <Checkbox
+                    id={`target-${tgt.id}`}
+                    checked={selected.includes(tgt.id)}
+                    onCheckedChange={() => toggleTarget(tgt.id)}
+                  />
+                  <Label htmlFor={`target-${tgt.id}`} className="flex items-center gap-2 text-sm">
+                    {tgt.name}
+                    {isAlreadyInstalled && (
+                      <CheckCircle2 className="h-3.5 w-3.5 text-green-500" />
+                    )}
+                  </Label>
+                </div>
+              )
+            })
+          )}
+        </div>
+
+        <p className="text-xs text-muted-foreground">
+          {t('installDialog.apiKeyNote')}
+        </p>
+
+        <DialogFooter>
+          <Button variant="outline" onClick={() => onOpenChange(false)}>
+            {tc('cancel')}
+          </Button>
+          <Button
+            onClick={handleInstall}
+            disabled={installing || selected.length === 0}
+          >
+            {installing && <Loader2 className="mr-2 h-4 w-4 animate-spin" />}
+            {t('actions.install')}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  )
+}

package/web/index.ts

@@ -14,6 +14,8 @@ export { default as aiMessagesEnUS } from './messages/en-US.json';
 // Pages
 export { default as AiCliToolsPage } from './pages/AiCliToolsPage';
 export { default as WorkspacesPage } from './pages/WorkspacesPage';
+export { default as SkillsPage } from './pages/SkillsPage';
 
 // Services
 export { aiCliService } from './services/ai-cli-service';
+export { skillService } from './services/skill-service';

package/web/manifest.ts

@@ -10,5 +10,6 @@ export const aiFrontendManifest: IFrontendManifest = {
   pages: [
     { path: '/ai-tools', titleKey: 'aiCli.pages.tools', icon: 'Terminal' },
     { path: '/ai-tools/workspaces', titleKey: 'aiCli.pages.workspaces', icon: 'Terminal' },
+    { path: '/ai-tools/skills', titleKey: 'aiSkills.pages.skills', icon: 'Sparkles' },
   ],
 };