@sylphx/flow 2.17.0 → 2.18.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @sylphx/flow
 
+## 2.18.1 (2025-12-18)
+
+### 🐛 Bug Fixes
+
+- **commands:** skills must be explicitly invoked, not auto-activated ([ecfb44c](https://github.com/SylphxAI/flow/commit/ecfb44c03b92fe0ef7e13152e4ff7e1bcf9b5fcb))
+
+### 📚 Documentation
+
+- **commands:** clarify skills contain implementation guidelines ([c53522c](https://github.com/SylphxAI/flow/commit/c53522c108d1c048c6dfe0bc33bd28c92dc75973))
+
+## 2.18.0 (2025-12-18)
+
+### ✨ Features
+
+- **cli:** show skills count in attach summary ([a02c422](https://github.com/SylphxAI/flow/commit/a02c42239e79af1cfc891bb4554e9fac7c2a7f9b))
+
 ## 2.17.0 (2025-12-18)
 
 ### ✨ Features

package/assets/slash-commands/continue.md

@@ -58,12 +58,15 @@ These questions reveal incompleteness that checklists miss.
 
 5. **Fix completely** — Don't patch. Understand root cause. Implement proper solution. Test it works.
 
-## Skills
+## Skills (Guidelines)
 
-Domain knowledge auto-activates when relevant. Available skills:
+**Skills contain implementation guidelines** — tech stack decisions, non-negotiables, patterns, anti-patterns for each domain.
 
+Available skills:
 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 MUST invoke relevant skills** using the Skill tool before fixing. This loads the guidelines for that domain.
+
 ## Loop
 
 After fixing: "Did my fixes introduce new gaps? Did fixing X reveal Y was also broken?"

package/assets/slash-commands/review.md

@@ -17,13 +17,14 @@ args:
 * **Delegate workers** for parallel research. You synthesize and verify.
 * **Fix, don't report.** Implement solutions directly.
 
-## Skills
+## Skills (Guidelines)
 
-Domain knowledge is available through Skills that auto-activate based on context:
+**Skills contain implementation guidelines** — tech stack decisions, non-negotiables, patterns, anti-patterns for each domain.
 
+Available skills:
 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.
+**You MUST invoke relevant skills** using the Skill tool before reviewing. This loads the guidelines for that domain.
 
 ## Output
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/flow",
-	"version": "2.17.0",
+	"version": "2.18.1",
 	"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/commands/flow/execute-v2.ts

@@ -15,7 +15,7 @@ import { GlobalConfigService } from '../../services/global-config.js';
 import { TargetInstaller } from '../../services/target-installer.js';
 import type { RunCommandOptions } from '../../types.js';
 import { extractAgentInstructions, loadAgentContent } from '../../utils/agent-enhancer.js';
-import { showHeader } from '../../utils/display/banner.js';
+import { showAttachSummary, showHeader } from '../../utils/display/banner.js';
 import { CLIError } from '../../utils/error-handler.js';
 import { UserCancelledError } from '../../utils/errors.js';
 import { ensureTargetInstalled, promptForTargetSelection } from '../../utils/target-selection.js';
@@ -263,6 +263,9 @@ export async function executeFlowV2(
       merge: options.merge || false,
     });
 
+    // Show attach summary
+    showAttachSummary(attachResult);
+
     const targetId = selectedTargetId;
 
     // Provider selection (Claude Code only, silent unless prompting)

package/src/core/flow-executor.ts

@@ -55,7 +55,13 @@ export class FlowExecutor {
   async execute(
     projectPath: string,
     options: FlowExecutorOptions = {}
-  ): Promise<{ joined: boolean; agents?: number; commands?: number; mcp?: number }> {
+  ): Promise<{
+    joined: boolean;
+    agents?: number;
+    commands?: number;
+    skills?: number;
+    mcp?: number;
+  }> {
     // Initialize Flow directories
     await this.projectManager.initialize();
 

package/src/utils/display/banner.ts

@@ -12,6 +12,40 @@ export function showHeader(version: string, target: string): void {
   console.log(`\n${chalk.cyan('flow')} ${chalk.dim(version)} ${chalk.dim('→')} ${target}\n`);
 }
 
+/**
+ * Show attach summary: ✓ Attached {n} agents, {n} commands, {n} skills, {n} MCP
+ */
+export function showAttachSummary(result: {
+  joined: boolean;
+  agents?: number;
+  commands?: number;
+  skills?: number;
+  mcp?: number;
+}): void {
+  if (result.joined) {
+    // Joining existing session - no summary needed
+    return;
+  }
+
+  const parts: string[] = [];
+  if (result.agents && result.agents > 0) {
+    parts.push(`${result.agents} agents`);
+  }
+  if (result.commands && result.commands > 0) {
+    parts.push(`${result.commands} commands`);
+  }
+  if (result.skills && result.skills > 0) {
+    parts.push(`${result.skills} skills`);
+  }
+  if (result.mcp && result.mcp > 0) {
+    parts.push(`${result.mcp} MCP`);
+  }
+
+  if (parts.length > 0) {
+    console.log(`${chalk.green('✓')} Attached ${parts.join(', ')}`);
+  }
+}
+
 /**
  * @deprecated Use showHeader instead
  */