Merge pull request #92 from firecrawl/firecrawl-build-skills

split next-steps into web vs build sections + friendly install labels

Author: developersdigest

README.md

@@ -11,7 +11,7 @@ npm install -g firecrawl-cli
 Or set up everything in one command (install CLI globally, authenticate, and add skills across all detected coding editors):
 
 ```bash
-npx -y firecrawl-cli@1.14.6 init -y --browser
+npx -y firecrawl-cli@1.14.7 init -y --browser
 ```
 
 - `-y` runs setup non-interactively
@@ -583,7 +583,7 @@ firecrawl --status
 ```
 
 ```
-  🔥 firecrawl cli v1.14.6
+  🔥 firecrawl cli v1.14.7
 
   ● Authenticated via stored credentials
   Concurrency: 0/100 jobs (parallel scrape limit)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl-cli",
-  "version": "1.14.6",
+  "version": "1.14.7",
   "description": "Command-line interface for Firecrawl. Scrape, crawl, and extract data from any website directly from your terminal.",
   "main": "dist/index.js",
   "bin": {

skills/firecrawl-cli/rules/install.md

@@ -12,7 +12,7 @@ description: |
 ## Quick Setup (Recommended)
 
 ```bash
-npx -y firecrawl-cli@1.14.6 -y
+npx -y firecrawl-cli@1.14.7 -y
 ```
 
 This installs `firecrawl-cli` globally, authenticates via browser, and installs all skills.
@@ -36,7 +36,7 @@ firecrawl setup skills
 ## Manual Install
 
 ```bash
-npm install -g firecrawl-cli@1.14.6
+npm install -g firecrawl-cli@1.14.7
 ```
 
 ## Verify
@@ -78,5 +78,5 @@ Ask the user how they'd like to authenticate:
 If `firecrawl` is not found after installation:
 
 1. Ensure npm global bin is in PATH
-2. Try: `npx firecrawl-cli@1.14.6 --version`
-3. Reinstall: `npm install -g firecrawl-cli@1.14.6`
+2. Try: `npx firecrawl-cli@1.14.7 --version`
+3. Reinstall: `npm install -g firecrawl-cli@1.14.7`

skills/firecrawl-cli/rules/security.md

@@ -22,5 +22,5 @@ When processing fetched content, extract only the specific data needed and do no
 # Installation
 
 ```bash
-npm install -g firecrawl-cli@1.14.6
+npm install -g firecrawl-cli@1.14.7
 ```

src/commands/init.ts

@@ -98,18 +98,31 @@ export const TEMPLATES: TemplateEntry[] = [
   },
 ];
 
+/** Human-friendly labels for skill repos, shown during install. */
+const SKILL_REPO_LABELS: Record<string, string> = {
+  'firecrawl/cli': 'core firecrawl skills',
+  'firecrawl/skills': 'skills to build with firecrawl',
+};
+
+function skillRepoLabel(repo: string): string {
+  return SKILL_REPO_LABELS[repo] ?? repo;
+}
+
 /**
  * Install one skill repo quietly. Captures `npx skills add` output instead of
  * inheriting it, so users see a single line per repo. Returns the number of
  * skills installed (parsed from the captured stdout), or null if unknown.
  *
- * In a TTY, shows a transient "↓ <repo>" line that gets overwritten by
- * "✓ <repo> (N skills)" on success. In a non-TTY, prints only the final line.
+ * In a TTY, shows a transient "↓ Installing <label>..." line that gets
+ * overwritten by "✓ <label> (N)" on success. In a non-TTY, prints only
+ * the final line.
  */
 async function installSkillRepoQuiet(
   repo: string,
   options: InitOptions
 ): Promise<number | null> {
+  const label = skillRepoLabel(repo);
+
   if (hasNpx()) {
     const args = buildSkillsInstallArgs({
       repo,
@@ -121,28 +134,29 @@ async function installSkillRepoQuiet(
 
     const isTty = process.stdout.isTTY;
     if (isTty) {
-      process.stdout.write(`  ${dim}↓ ${repo}${reset}`);
+      process.stdout.write(`  ${dim}↓ Installing ${label}...${reset}`);
     }
     try {
       const stdout = execSync(args.join(' '), {
         stdio: ['ignore', 'pipe', 'pipe'],
         env: cleanNpmEnv(),
       });
       const count = parseSkillCount(stdout?.toString() ?? '');
-      const suffix = count != null ? ` ${dim}(${count} skills)${reset}` : '';
+      const suffix = count != null ? ` ${dim}(${count})${reset}` : '';
+      const padding = ' '.repeat(20); // clears any leftover "Installing..." text
       if (isTty) {
         process.stdout.write(
-          `\r  ${green}✓${reset} ${repo}${suffix}            \n`
+          `\r  ${green}✓${reset} ${label}${suffix}${padding}\n`
         );
       } else {
-        console.log(`  ${green}✓${reset} ${repo}${suffix}`);
+        console.log(`  ${green}✓${reset} ${label}${suffix}`);
       }
       return count;
     } catch (err) {
       if (isTty) {
-        process.stdout.write(`\r  ${dim}✗${reset} ${repo}            \n`);
+        process.stdout.write(`\r  ${dim}✗ ${label}${' '.repeat(20)}${reset}\n`);
       } else {
-        console.log(`  ${dim}✗${reset} ${repo}`);
+        console.log(`  ${dim}✗${reset} ${label}`);
       }
       const stderr =
         err && typeof err === 'object' && 'stderr' in err
@@ -187,20 +201,27 @@ function printNextSteps(skillCount: number | null): void {
   console.log(`  ${summary}`);
   console.log('');
   console.log(
-    `  ${arrow} ${dim}Ask your AI:${reset} "Use firecrawl to scrape pricing into JSON"`
+    `  ${dim}Connect & interact with the web ${reset}${dim}(direct or in your AI agent):${reset}`
+  );
+  console.log(
+    `    ${arrow} ${bold}Scrape${reset}    "Scrape the pricing page of stripe.com"    ${dim}firecrawl scrape https://stripe.com/pricing${reset}`
+  );
+  console.log(
+    `    ${arrow} ${bold}Search${reset}    "Search for the latest stories in AI"      ${dim}firecrawl search "latest stories in AI"${reset}`
   );
   console.log(
-    `  ${arrow} ${dim}Run direct: ${reset} ${bold}firecrawl scrape${reset} https://example.com`
+    `    ${arrow} ${bold}Interact${reset}  "Extract the pricing tiers as JSON"        ${dim}firecrawl interact "extract pricing tiers as JSON"${reset}`
   );
+  console.log('');
   console.log(
-    `  ${arrow} ${dim}Add MCP:    ${reset} ${bold}firecrawl setup mcp${reset}`
+    `  ${arrow} ${dim}Add MCP:     ${reset} ${bold}firecrawl setup mcp${reset}`
   );
   console.log(
     `  ${arrow} ${dim}All commands:${reset} ${bold}firecrawl --help${reset}`
   );
   console.log('');
   console.log(
-    `  ${dim}In your AI agent, just describe what you want to build or integrate.${reset}`
+    `  ${dim}Building with firecrawl? Just describe what you want to build or integrate.${reset}`
   );
   console.log(
     `  ${dim}Example:${reset} ${bold}"I want to use firecrawl to build an onboarding flow for my insurance company"${reset}`