docs: quote URLs in CLI examples

Author: yangpten

README.md

@@ -60,13 +60,13 @@ Additional packaged skills live under `skills/`, including `skills/youtube-to-bl
 
 ```bash
 # Scrape a webpage (default: markdown)
-dumplingai scrape https://docs.example.com
+dumplingai scrape 'https://docs.example.com'
 
 # Scrape and save to file
-dumplingai scrape https://example.com/article -o article.md
+dumplingai scrape 'https://example.com/article' -o article.md
 
 # URL shortcut — no subcommand needed
-dumplingai https://example.com
+dumplingai 'https://example.com'
 
 # Web search
 dumplingai search "TypeScript 5.5 new features"
@@ -75,11 +75,12 @@ dumplingai search "TypeScript 5.5 new features"
 dumplingai search "best React state management" --scrape
 
 # Get YouTube transcript
-dumplingai transcript https://youtube.com/watch?v=dQw4w9WgXcQ
+dumplingai transcript 'https://youtube.com/watch?v=dQw4w9WgXcQ'
 
 # Output as JSON
-dumplingai scrape https://example.com --json
+dumplingai scrape 'https://example.com' --json
 ```
+Quote URLs in shell examples by default. This avoids `zsh` globbing issues with characters like `?` and keeps commands copy-paste safe.
 
 ---
 

packages/cli/README.md

@@ -34,7 +34,13 @@ npx skills add dumplingai/cli --skill dumplingai-cli --skill youtube-to-blog-pos
 
 ```bash
 dumplingai login --api-key sk_yourkey
-dumplingai scrape https://example.com
+dumplingai scrape 'https://example.com'
+```
+
+Quote URLs in shell examples by default so special characters like `?` are passed through safely.
+
+```bash
+dumplingai transcript 'https://youtube.com/watch?v=dQw4w9WgXcQ'
 ```
 
 ## Commands

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dumplingai-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "DumplingAI CLI — scrape, search, and extract from the terminal",
   "license": "MIT",
   "type": "module",

packages/cli/src/commands/init.ts

@@ -78,7 +78,7 @@ export function makeInitCommand(): Command {
         await runSkillSetup();
       }
 
-      printStatus('\nDone! Try: dumplingai scrape https://example.com');
+      printStatus("\nDone! Try: dumplingai scrape 'https://example.com'");
     });
 }
 

packages/cli/src/commands/setup-skill.ts

@@ -36,17 +36,19 @@ description: Use when working with the DumplingAI CLI to scrape webpages, search
 
 \`\`\`bash
 # Scrape a webpage
-dumplingai scrape https://example.com -o .dumplingai/page.md
+dumplingai scrape 'https://example.com' -o .dumplingai/page.md
 
 # Web search
 dumplingai search "TypeScript best practices 2024" --json
 
 # Get a YouTube transcript
-dumplingai transcript https://youtube.com/watch?v=dQw4w9WgXcQ -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=dQw4w9WgXcQ' -o .dumplingai/transcript.txt
 
 # URL shortcut (auto-forwards to scrape)
-dumplingai https://example.com
+dumplingai 'https://example.com'
 \`\`\`
+
+Quote URLs in shell examples by default so special characters like \`?\` are passed through unchanged.
 `,
       'rules/safety.md': `# Safety Rules
 
@@ -118,9 +120,9 @@ Turn a YouTube video into a structured blog post using the DumplingAI CLI.
 Always write intermediate artifacts to \`.dumplingai/\`:
 
 \`\`\`bash
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 dumplingai search "concept referenced in the video" -o .dumplingai/search.md
-dumplingai scrape https://example.com/reference -o .dumplingai/reference.md
+dumplingai scrape 'https://example.com/reference' -o .dumplingai/reference.md
 \`\`\`
 
 Then read incrementally:
@@ -137,6 +139,8 @@ sed -n '80,180p' .dumplingai/transcript.txt
 - Remove filler, repetition, sponsor reads, and off-topic asides
 - Convert spoken language into tighter written prose
 - If the transcript is noisy or incomplete, produce an outline first and flag uncertainty
+
+Quote URLs in shell examples by default so special characters like \`?\` are passed through to the CLI.
 `,
       'rules/safety.md': `# Safety Rules
 
@@ -183,8 +187,8 @@ Write research artifacts to \`.dumplingai/\` before drafting:
 
 \`\`\`bash
 dumplingai search "AI sales assistant pain points for SMB founders" -o .dumplingai/search.md
-dumplingai scrape https://example.com/product-page -o .dumplingai/product.md
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai scrape 'https://example.com/product-page' -o .dumplingai/product.md
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 \`\`\`
 
 Then read incrementally:
@@ -204,6 +208,8 @@ sed -n '1,120p' .dumplingai/product.md
 - Avoid hashtags unless the user asks for them
 - Produce multiple variants when tone is ambiguous
 - Default to one version per requested platform, not one generic post
+
+Quote URLs in shell examples by default so special characters like \`?\` do not get expanded before \`dumplingai\` runs.
 `,
       'rules/safety.md': `# Safety Rules
 

skills/dumplingai-cli/SKILL.md

@@ -29,9 +29,9 @@ When gathering web content, prefer in this order:
 Always write large outputs to `.dumplingai/` to keep context clean:
 
 ```bash
-dumplingai scrape https://example.com -o .dumplingai/page.md
+dumplingai scrape 'https://example.com' -o .dumplingai/page.md
 dumplingai search "TypeScript 5.5 features" -o .dumplingai/search.md
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 ```
 
 Then read incrementally:
@@ -44,20 +44,21 @@ rg "function" .dumplingai/page.md
 
 ```bash
 # Quick scrape (markdown, default)
-dumplingai scrape https://docs.example.com/guide
+dumplingai scrape 'https://docs.example.com/guide'
 
 # HTML scrape
-dumplingai scrape https://example.com --format html -o .dumplingai/raw.html
+dumplingai scrape 'https://example.com' --format html -o .dumplingai/raw.html
 
 # Search and scrape top results
 dumplingai search "best TypeScript ORMs 2024" --scrape --json
 
 # Get transcript in Spanish
-dumplingai transcript https://youtube.com/watch?v=ID --lang es
+dumplingai transcript 'https://youtube.com/watch?v=ID' --lang es
 
 # URL shortcut (no subcommand needed)
-dumplingai https://example.com/article
+dumplingai 'https://example.com/article'
 ```
+Quote URLs in shell examples by default so special characters like `?` are passed through unchanged.
 
 ## Safety
 

skills/social-media-post/SKILL.md

@@ -44,8 +44,8 @@ Write research artifacts to `.dumplingai/` before drafting:
 
 ```bash
 dumplingai search "AI sales assistant pain points for SMB founders" -o .dumplingai/search.md
-dumplingai scrape https://example.com/product-page -o .dumplingai/product.md
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai scrape 'https://example.com/product-page' -o .dumplingai/product.md
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 ```
 
 Then read incrementally:
@@ -73,11 +73,12 @@ sed -n '1,120p' .dumplingai/product.md
 dumplingai search "B2B SaaS onboarding mistakes founder audience" -o .dumplingai/search.md
 
 # Pull a primary source if available
-dumplingai scrape https://example.com/blog-post -o .dumplingai/source.md
+dumplingai scrape 'https://example.com/blog-post' -o .dumplingai/source.md
 
 # Optional: use a video as source material
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 ```
+Quote URLs in shell examples by default so special characters like `?` do not get expanded before `dumplingai` runs.
 
 ## Safety
 

skills/youtube-to-blog-post/SKILL.md

@@ -37,9 +37,9 @@ dumplingai scrape <url>               # Read specific references in depth
 Always write intermediate artifacts to `.dumplingai/`:
 
 ```bash
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 dumplingai search "company or concept from the video" -o .dumplingai/search.md
-dumplingai scrape https://example.com/reference -o .dumplingai/reference.md
+dumplingai scrape 'https://example.com/reference' -o .dumplingai/reference.md
 ```
 
 Then read incrementally:
@@ -62,14 +62,15 @@ sed -n '80,180p' .dumplingai/transcript.txt
 
 ```bash
 # Step 1: fetch the transcript
-dumplingai transcript https://youtube.com/watch?v=ID -o .dumplingai/transcript.txt
+dumplingai transcript 'https://youtube.com/watch?v=ID' -o .dumplingai/transcript.txt
 
 # Step 2: verify referenced claims if needed
 dumplingai search "site:docs.example.com feature mentioned in the video" -o .dumplingai/search.md
 
 # Step 3: scrape the best supporting source
-dumplingai scrape https://docs.example.com/feature -o .dumplingai/feature.md
+dumplingai scrape 'https://docs.example.com/feature' -o .dumplingai/feature.md
 ```
+Quote URLs in shell examples by default so special characters like `?` are passed through to the CLI.
 
 ## Safety