npm - @sylphx/flow - Versions diffs - 2.16.1 → 2.17.0 - Mend

@sylphx/flow 2.16.1 → 2.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,25 @@
 # @sylphx/flow
+## 2.17.0 (2025-12-18)
+### ✨ Features
+- **skills:** implement skills loading and attach pipeline ([8d720b8](https://github.com/SylphxAI/flow/commit/8d720b8118ffe19e14d50aaacd9282bd5d42e702))
+## 2.16.2 (2025-12-17)
+### 🐛 Bug Fixes
+- **commands:** tell LLM to use SlashCommand tool for /review and /continue ([6983015](https://github.com/SylphxAI/flow/commit/6983015b97e89a48e973106828672b8b3000dce8))
+### ♻️ Refactoring
+- **assets:** convert guidelines to Skills (model-invoked) ([2eb8d01](https://github.com/SylphxAI/flow/commit/2eb8d01162f00a127c5666c8afd9b63fc477ea42))
+### 🔧 Chores
+- trigger release workflow ([69d661c](https://github.com/SylphxAI/flow/commit/69d661c582157650df855a3a31e21ad6a8b3e7bf))
 ## 2.16.1 (2025-12-17)
 ### ♻️ Refactoring

package/assets/{slash-commands/guideline-account-security.md → skills/account-security/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-account-security
-description: Guideline: account security - sessions, MFA, devices, security events
-agent: coder
+name: account-security
+description: Account security - MFA, sessions, recovery. Use when protecting user accounts.
 ---
 # Account Security Guideline

package/assets/{slash-commands/guideline-admin.md → skills/admin/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-admin
-description: Guideline: admin - RBAC, bootstrap, audit, operational tools
-agent: coder
+name: admin
+description: Admin panel - RBAC, config, admin tools. Use when building admin UI.
 ---
 # Admin Guideline

package/assets/{slash-commands/guideline-auth.md → skills/auth/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-auth
-description: Guideline: authentication - sign-in, SSO, passkeys, verification
-agent: coder
+name: auth
+description: Authentication patterns - sign-in, SSO, passkeys, sessions. Use when implementing auth flows.
 ---
 # Auth Guideline

package/assets/{slash-commands/guideline-billing.md → skills/billing/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-billing
-description: Guideline: billing - Stripe integration, webhooks, subscription state
-agent: coder
+name: billing
+description: Billing - Stripe, webhooks, subscriptions. Use when implementing payments.
 ---
 # Billing Guideline

package/assets/{slash-commands/guideline-code-quality.md → skills/code-quality/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-code-quality
-description: Guideline: code quality - architecture, types, testing, maintainability
-agent: coder
+name: code-quality
+description: Code quality - patterns, testing, maintainability. Use for code review.
 ---
 # Code Quality Guideline

package/assets/{slash-commands/guideline-data-architecture.md → skills/data-architecture/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-data-architecture
-description: Guideline: data architecture - boundaries, consistency, state machines
-agent: coder
+name: data-architecture
+description: Data architecture - models, relationships. Use when designing data structures.
 ---
 # Data Architecture Guideline

package/assets/{slash-commands/guideline-database.md → skills/database/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-database
-description: Guideline: database - schema, migrations, performance, reliability
-agent: coder
+name: database
+description: Database - schema, indexes, migrations. Use when working with databases.
 ---
 # Database Guideline

package/assets/{slash-commands/guideline-delivery.md → skills/delivery/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-delivery
-description: Guideline: delivery - CI gates, automated verification, release safety
-agent: coder
+name: delivery
+description: Delivery - CI/CD, testing, releases. Use when improving pipelines.
 ---
 # Delivery Guideline

package/assets/{slash-commands/guideline-discovery.md → skills/discovery/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-discovery
-description: Guideline: discovery - competitive research, opportunities, market positioning
-agent: coder
+name: discovery
+description: Feature discovery - competitive analysis. Use when exploring features.
 ---
 # Discovery Guideline

package/assets/{slash-commands/guideline-growth.md → skills/growth/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-growth
-description: Guideline: growth - activation, retention, virality
-agent: coder
+name: growth
+description: Growth - onboarding, activation, retention. Use for growth features.
 ---
 # Growth Guideline

package/assets/{slash-commands/guideline-i18n.md → skills/i18n/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-i18n
-description: Guideline: i18n - localization, routing, translation quality
-agent: coder
+name: i18n
+description: Internationalization - localization, translations. Use when adding languages.
 ---
 # i18n Guideline

package/assets/{slash-commands/guideline-ledger.md → skills/ledger/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-ledger
-description: Guideline: ledger - balance systems, financial integrity, reconciliation
-agent: coder
+name: ledger
+description: Financial ledger - transactions, audit trails. Use when tracking money.
 ---
 # Ledger Guideline

package/assets/{slash-commands/guideline-observability.md → skills/observability/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-observability
-description: Guideline: observability - logging, tracing, alerting, debugging
-agent: coder
+name: observability
+description: Observability - logging, metrics, tracing. Use when adding monitoring.
 ---
 # Observability Guideline

package/assets/{slash-commands/guideline-operability.md → skills/operability/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-operability
-description: Guideline: operability - workflows, retries, DLQ, incident response
-agent: coder
+name: operability
+description: Operations - deployment, rollback, feature flags. Use for ops tooling.
 ---
 # Operability Guideline

package/assets/{slash-commands/guideline-performance.md → skills/performance/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-performance
-description: Guideline: performance - speed, Core Web Vitals, bottlenecks
-agent: coder
+name: performance
+description: Performance - Core Web Vitals, bundle size. Use when optimizing speed.
 ---
 # Performance Guideline

package/assets/{slash-commands/guideline-pricing.md → skills/pricing/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-pricing
-description: Guideline: pricing - strategy, packaging, monetization
-agent: coder
+name: pricing
+description: Pricing strategy - tiers, feature gating. Use when designing pricing.
 ---
 # Pricing Guideline

package/assets/{slash-commands/guideline-privacy.md → skills/privacy/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-privacy
-description: Guideline: privacy - consent, PII, data lifecycle, compliance
-agent: coder
+name: privacy
+description: Privacy and data protection - GDPR, CCPA, consent. Use when handling user data.
 ---
 # Privacy Guideline

package/assets/{slash-commands/guideline-pwa.md → skills/pwa/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-pwa
-description: Guideline: PWA - offline experience, installation, engagement
-agent: coder
+name: pwa
+description: PWA - service workers, offline support. Use when building PWA features.
 ---
 # PWA Guideline

package/assets/{slash-commands/guideline-referral.md → skills/referral/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-referral
-description: Guideline: referral - attribution, rewards, fraud prevention
-agent: coder
+name: referral
+description: Referral systems - referral programs, viral loops. Use for referrals.
 ---
 # Referral Guideline

package/assets/{slash-commands/guideline-security.md → skills/security/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-security
-description: Guideline: security - OWASP, headers, authentication, secrets
-agent: coder
+name: security
+description: Application security - OWASP, validation, secrets. Use when securing the app.
 ---
 # Security Guideline

package/assets/{slash-commands/guideline-seo.md → skills/seo/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-seo
-description: Guideline: SEO - discoverability, metadata, search rankings
-agent: coder
+name: seo
+description: SEO - meta tags, structured data. Use when optimizing for search.
 ---
 # SEO Guideline

package/assets/{slash-commands/guideline-storage.md → skills/storage/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-storage
-description: Guideline: storage - uploads, file handling, security
-agent: coder
+name: storage
+description: File storage - uploads, CDN, blobs. Use when handling files.
 ---
 # Storage Guideline

package/assets/{slash-commands/guideline-support.md → skills/support/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-support
-description: Guideline: support - help experience, communications, user satisfaction
-agent: coder
+name: support
+description: Support - help center, tickets, docs. Use when building support.
 ---
 # Support Guideline

package/assets/{slash-commands/guideline-trust-safety.md → skills/trust-safety/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-trust-safety
-description: Guideline: trust & safety - abuse prevention, moderation, user protection
-agent: coder
+name: trust-safety
+description: Trust and safety - abuse prevention, rate limiting. Use when fighting bad actors.
 ---
 # Trust Safety Guideline

package/assets/{slash-commands/guideline-uiux.md → skills/uiux/SKILL.md} RENAMED Viewed

@@ -1,7 +1,6 @@
 ---
-name: guideline-uiux
-description: Guideline: UI/UX - design system, accessibility, user experience
-agent: coder
+name: uiux
+description: UI/UX - design system, accessibility. Use when building interfaces.
 ---
 # UI/UX Guideline

package/assets/slash-commands/continue.md CHANGED Viewed

@@ -58,24 +58,17 @@ These questions reveal incompleteness that checklists miss.
 5. **Fix completely** — Don't patch. Understand root cause. Implement proper solution. Test it works.
-## When to Go Deeper
+## Skills
-If issues cluster in a domain, invoke `/review <domain>` for thorough analysis:
+Domain knowledge auto-activates when relevant. Available skills:
-```
-/review auth        — Auth flow issues
-/review security    — Validation gaps, injection risks
-/review database    — Schema issues, missing indexes
-/review performance — Slow paths, bundle bloat
-```
-Full list: auth, account-security, privacy, billing, pricing, ledger, security, trust-safety, uiux, seo, pwa, performance, i18n, database, data-architecture, storage, observability, operability, delivery, growth, referral, support, admin, discovery, code-quality
+auth, account-security, privacy, billing, pricing, ledger, security, trust-safety, uiux, seo, pwa, performance, i18n, database, data-architecture, storage, observability, operability, delivery, growth, referral, support, admin, discovery, code-quality
 ## Loop
-After fixing, ask: "Did my fixes introduce new gaps? Did fixing X reveal Y was also broken?"
+After fixing: "Did my fixes introduce new gaps? Did fixing X reveal Y was also broken?"
-If yes → continue. If no Critical/High issues remain → done.
+If yes → run `/continue` again. If no Critical/High issues remain → done.
 ## Output
@@ -94,5 +87,5 @@ If yes → continue. If no Critical/High issues remain → done.
 ## Next
-[/continue again | /review <domain> | done]
+[/continue again | done]
 ```

package/assets/slash-commands/review.md CHANGED Viewed

@@ -1,10 +1,10 @@
 ---
 name: review
-description: Review codebase by domain - /review <what to review>
+description: Review codebase by topic - /review <what to review>
 agent: coder
 args:
   - name: topic
-    description: What to review (e.g., auth, security, billing, "the login flow", "why it's slow")
+    description: What to review (e.g., auth, security, "the login flow", "why it's slow")
     required: true
 ---
@@ -12,42 +12,18 @@ args:
 ## Mandate
-* **Understand first.** Don't treat guidelines as checklists — absorb the principles, then apply judgment.
+* **Understand first.** Absorb the principles, then apply judgment.
 * **Think like the failure mode.** Security? Think like an attacker. Performance? Think like a slow network. Auth? Think like a confused user.
 * **Delegate workers** for parallel research. You synthesize and verify.
 * **Fix, don't report.** Implement solutions directly.
-## Available Guidelines
+## Skills
-Read relevant guideline(s) based on what you're reviewing:
+Domain knowledge is available through Skills that auto-activate based on context:
-| Guideline | Domain |
-|-----------|--------|
-| `/guideline-auth` | Sign-in, SSO, passkeys, verification |
-| `/guideline-account-security` | MFA, sessions, account recovery |
-| `/guideline-privacy` | Data handling, consent, GDPR/CCPA |
-| `/guideline-billing` | Stripe, webhooks, subscriptions |
-| `/guideline-pricing` | Pricing models, tiers, feature gating |
-| `/guideline-ledger` | Transactions, audit trails, reconciliation |
-| `/guideline-security` | OWASP, validation, secrets |
-| `/guideline-trust-safety` | Abuse prevention, rate limiting, fraud |
-| `/guideline-uiux` | Design system, accessibility |
-| `/guideline-seo` | Meta tags, structured data, crawlability |
-| `/guideline-pwa` | Service workers, offline, installability |
-| `/guideline-performance` | Core Web Vitals, bundle size, caching |
-| `/guideline-i18n` | Localization, routing, hreflang |
-| `/guideline-database` | Schema, indexes, migrations |
-| `/guideline-data-architecture` | Data models, relationships, integrity |
-| `/guideline-storage` | File uploads, CDN, blob storage |
-| `/guideline-observability` | Logging, metrics, tracing, alerts |
-| `/guideline-operability` | Deployment, rollback, feature flags |
-| `/guideline-delivery` | CI/CD, testing, release process |
-| `/guideline-growth` | Onboarding, activation, retention |
-| `/guideline-referral` | Referral programs, viral loops |
-| `/guideline-support` | Help systems, tickets, documentation |
-| `/guideline-admin` | Admin panel, RBAC, config |
-| `/guideline-discovery` | Feature discovery, competitive analysis |
-| `/guideline-code-quality` | Patterns, testing, maintainability |
+auth, account-security, privacy, billing, pricing, ledger, security, trust-safety, uiux, seo, pwa, performance, i18n, database, data-architecture, storage, observability, operability, delivery, growth, referral, support, admin, discovery, code-quality
+You don't need to invoke them — they activate when relevant.
 ## Output

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "2.16.1",
+	"version": "2.17.0",
 	"description": "One CLI to rule them all. Unified orchestration layer for Claude Code, OpenCode, Cursor and all AI development tools. Auto-detection, auto-installation, auto-upgrade.",
 	"type": "module",
 	"bin": {

package/src/core/attach-manager.ts CHANGED Viewed

@@ -21,6 +21,8 @@ export interface AttachResult {
   agentsOverridden: string[];
   commandsAdded: string[];
   commandsOverridden: string[];
+  skillsAdded: string[];
+  skillsOverridden: string[];
   rulesAppended: boolean;
   mcpServersAdded: string[];
   mcpServersOverridden: string[];
@@ -31,7 +33,7 @@ export interface AttachResult {
 }
 export interface ConflictInfo {
-  type: 'agent' | 'command' | 'mcp' | 'hook';
+  type: 'agent' | 'command' | 'skill' | 'mcp' | 'hook';
   name: string;
   action: 'overridden' | 'merged';
   message: string;
@@ -40,6 +42,7 @@ export interface ConflictInfo {
 export interface FlowTemplates {
   agents: Array<{ name: string; content: string }>;
   commands: Array<{ name: string; content: string }>;
+  skills: Array<{ name: string; content: string }>;
   rules?: string;
   mcpServers: Array<{ name: string; config: Record<string, unknown> }>;
   hooks: Array<{ name: string; content: string }>;
@@ -143,6 +146,8 @@ export class AttachManager {
       agentsOverridden: [],
       commandsAdded: [],
       commandsOverridden: [],
+      skillsAdded: [],
+      skillsOverridden: [],
       rulesAppended: false,
       mcpServersAdded: [],
       mcpServersOverridden: [],
@@ -160,12 +165,17 @@ export class AttachManager {
     // 2. Attach commands
     await this.attachCommands(projectPath, target, templates.commands, result, manifest);
-    // 3. Attach rules (if applicable)
+    // 3. Attach skills (if target supports them)
+    if (target.config.skillsDir && templates.skills.length > 0) {
+      await this.attachSkills(projectPath, target, templates.skills, result, manifest);
+    }
+    // 4. Attach rules (if applicable)
     if (templates.rules) {
       await this.attachRules(projectPath, target, templates.rules, result, manifest);
     }
-    // 4. Attach MCP servers (merge global + template servers)
+    // 5. Attach MCP servers (merge global + template servers)
     const globalMCPServers = await this.loadGlobalMCPServers(target);
     const allMCPServers = [...globalMCPServers, ...templates.mcpServers];
@@ -173,12 +183,12 @@ export class AttachManager {
       await this.attachMCPServers(projectPath, target, allMCPServers, result, manifest);
     }
-    // 5. Attach hooks
+    // 6. Attach hooks
     if (templates.hooks.length > 0) {
       await this.attachHooks(projectPath, target, templates.hooks, result, manifest);
     }
-    // 6. Attach single files
+    // 7. Attach single files
     if (templates.singleFiles.length > 0) {
       await this.attachSingleFiles(projectPath, templates.singleFiles, result, manifest);
     }
@@ -238,6 +248,45 @@ export class AttachManager {
     manifest.backup.commands.flow.push(...itemManifest.flow);
   }
+  /**
+   * Attach skills (override strategy)
+   * Skills are stored as <domain>/SKILL.md subdirectories
+   */
+  private async attachSkills(
+    projectPath: string,
+    target: Target,
+    skills: Array<{ name: string; content: string }>,
+    result: AttachResult,
+    manifest: BackupManifest
+  ): Promise<void> {
+    const skillsDir = path.join(projectPath, target.config.skillsDir!);
+    await fs.mkdir(skillsDir, { recursive: true });
+    for (const skill of skills) {
+      // skill.name is like "auth/SKILL.md" - create subdirectory
+      const skillPath = path.join(skillsDir, skill.name);
+      const skillSubDir = path.dirname(skillPath);
+      await fs.mkdir(skillSubDir, { recursive: true });
+      const existed = existsSync(skillPath);
+      if (existed) {
+        result.skillsOverridden.push(skill.name);
+        result.conflicts.push({
+          type: 'skill',
+          name: skill.name,
+          action: 'overridden',
+          message: `Skill '${skill.name}' overridden (will be restored on exit)`,
+        });
+        manifest.backup.skills.user.push(skillPath);
+      } else {
+        result.skillsAdded.push(skill.name);
+      }
+      await fs.writeFile(skillPath, skill.content);
+      manifest.backup.skills.flow.push(skillPath);
+    }
+  }
   /**
    * Attach rules (append strategy for AGENTS.md)
    * Uses shared attachRulesFile function

package/src/core/backup-manager.ts CHANGED Viewed

@@ -38,6 +38,10 @@ export interface BackupManifest {
       user: string[];
       flow: string[];
     };
+    skills: {
+      user: string[];
+      flow: string[];
+    };
     rules?: {
       path: string;
       originalSize: number;
@@ -114,6 +118,7 @@ export class BackupManager {
       backup: {
         agents: { user: [], flow: [] },
         commands: { user: [], flow: [] },
+        skills: { user: [], flow: [] },
         singleFiles: {},
       },
       secrets: {

package/src/core/flow-executor.ts CHANGED Viewed

@@ -137,6 +137,7 @@ export class FlowExecutor {
       joined: false,
       agents: attachResult.agentsAdded.length,
       commands: attachResult.commandsAdded.length,
+      skills: attachResult.skillsAdded.length,
       mcp: attachResult.mcpServersAdded.length,
     };
   }
@@ -184,7 +185,15 @@ export class FlowExecutor {
       }
     }
-    // 3. Clear hooks directory (in configDir)
+    // 3. Clear skills directory (if target supports skills)
+    if (target.config.skillsDir) {
+      const skillsDir = path.join(projectPath, target.config.skillsDir);
+      if (existsSync(skillsDir)) {
+        await fs.rm(skillsDir, { recursive: true, force: true });
+      }
+    }
+    // 4. Clear hooks directory (in configDir)
     const hooksDir = path.join(projectPath, target.config.configDir, 'hooks');
     if (existsSync(hooksDir)) {
       const files = await fs.readdir(hooksDir);
@@ -193,7 +202,7 @@ export class FlowExecutor {
       }
     }
-    // 4. Clear MCP configuration using target config
+    // 5. Clear MCP configuration using target config
     const configPath = path.join(projectPath, target.config.configFile);
     const mcpPath = target.config.mcpConfigPath;
@@ -206,7 +215,7 @@ export class FlowExecutor {
       }
     }
-    // 5. Clear rules file if target has one defined (for targets like OpenCode)
+    // 6. Clear rules file if target has one defined (for targets like OpenCode)
     // Claude Code puts AGENTS.md in agents directory, handled above
     if (target.config.rulesFile) {
       const rulesPath = path.join(projectPath, target.config.rulesFile);
@@ -215,7 +224,7 @@ export class FlowExecutor {
       }
     }
-    // 6. Clear single files (output styles) - currently none
+    // 7. Clear single files (output styles) - currently none
     // These would be in the configDir if we had any
     const singleFiles: string[] = [];
     for (const fileName of singleFiles) {
@@ -225,7 +234,7 @@ export class FlowExecutor {
       }
     }
-    // 7. Clean up any Flow-created files in project root (legacy bug cleanup)
+    // 8. Clean up any Flow-created files in project root (legacy bug cleanup)
     // This handles files that were incorrectly created in project root
     const legacySingleFiles = ['silent.md']; // Keep for cleanup of legacy installations
     for (const fileName of legacySingleFiles) {

package/src/core/template-loader.ts CHANGED Viewed

@@ -29,6 +29,7 @@ export class TemplateLoader {
     const templates: FlowTemplates = {
       agents: [],
       commands: [],
+      skills: [],
       rules: undefined,
       mcpServers: [],
       hooks: [],
@@ -47,6 +48,12 @@ export class TemplateLoader {
       templates.commands = await this.loadCommands(commandsDir);
     }
+    // Load skills (skills/<domain>/SKILL.md structure)
+    const skillsDir = path.join(this.assetsDir, 'skills');
+    if (existsSync(skillsDir)) {
+      templates.skills = await this.loadSkills(skillsDir);
+    }
     // Load rules (check multiple possible locations)
     const rulesLocations = [
       path.join(this.assetsDir, 'rules', 'AGENTS.md'),
@@ -115,6 +122,34 @@ export class TemplateLoader {
     return commands;
   }
+  /**
+   * Load skills from directory
+   * Skills are stored as <domain>/SKILL.md subdirectories
+   */
+  private async loadSkills(skillsDir: string): Promise<Array<{ name: string; content: string }>> {
+    const skills = [];
+    const domains = await fs.readdir(skillsDir);
+    for (const domain of domains) {
+      const domainPath = path.join(skillsDir, domain);
+      const stat = await fs.stat(domainPath);
+      if (!stat.isDirectory()) {
+        continue;
+      }
+      // Look for SKILL.md in each domain directory
+      const skillFile = path.join(domainPath, 'SKILL.md');
+      if (existsSync(skillFile)) {
+        const content = await fs.readFile(skillFile, 'utf-8');
+        // Name includes subdirectory: "auth/SKILL.md"
+        skills.push({ name: `${domain}/SKILL.md`, content });
+      }
+    }
+    return skills;
+  }
   /**
    * Load MCP servers configuration
    */

package/src/targets/claude-code.ts CHANGED Viewed

@@ -41,6 +41,7 @@ export const claudeCodeTarget: Target = {
     rulesFile: undefined, // Rules are included in agent files
     outputStylesDir: undefined, // Output styles are included in agent files
     slashCommandsDir: '.claude/commands',
+    skillsDir: '.claude/skills',
     installation: {
       createAgentDir: true,
       createConfigFile: true,

package/src/types/target.types.ts CHANGED Viewed

@@ -35,6 +35,8 @@ export interface TargetConfig {
   outputStylesDir?: string;
   /** Slash commands directory (optional, relative to project root) */
   slashCommandsDir?: string;
+  /** Skills directory (optional, relative to project root) */
+  skillsDir?: string;
   /** Installation-specific configuration */
   installation: {
     /** Whether to create the agent directory */
@@ -137,4 +139,7 @@ export interface Target {
   /** Setup slash commands for this target (optional - implement if target supports slash commands) */
   setupSlashCommands?(cwd: string, options: CommonOptions): Promise<SetupResult>;
+  /** Setup skills for this target (optional - implement if target supports skills) */
+  setupSkills?(cwd: string, options: CommonOptions): Promise<SetupResult>;
 }