From webflow-cli-skills
Diagnose and fix Webflow CLI issues including installation failures, authentication errors, build problems, and bundler issues using --verbose, --debug-bundler, and Bash diagnostics.
npx claudepluginhub webflow/webflow-skills --plugin webflow-cli-skillsThis skill uses the workspace's default tool permissions.
Diagnose and resolve Webflow CLI issues with diagnostic commands and automated fixes.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
Diagnose and resolve Webflow CLI issues with diagnostic commands and automated fixes.
ALWAYS use Bash tool for all diagnostic operations:
webflow --versionwebflow auth login (if needed)--verbose, --debug-bundler, --helpPackage Manager Detection:
package-lock.json (npm), pnpm-lock.yaml (pnpm), yarn.lock (yarn)webflow --versionwebflow auth login if needed--verbose flag for detailed output--debug-bundler flag to see bundler configwebflow <command> --help to verify command syntaxUser prompt:
Getting "webflow: command not found"
Diagnostics:
๐ Checking CLI Installation
Executing: webflow --version
Error: bash: webflow: command not found
โ Webflow CLI not installed
Fix:
๐ Fix: Install Webflow CLI
Executing: npm install -g @webflow/cli
โ CLI installed
Verifying...
Executing: webflow --version
Output: @webflow/cli/1.5.2
โ
Issue resolved
User prompt:
Build is failing but I don't know why
Diagnostics:
๐ Running Build with Diagnostics
Executing: webflow library bundle --verbose
Output:
[verbose] Loading webflow.json
[verbose] Found library config
[verbose] Building components from ./src/**/*.webflow.tsx
[verbose] Running bundler
Error: Failed to resolve import './missing-file.ts'
โ Build failed: Missing import file
Fix:
๐ Fix: Missing Import
Issue: Component imports './missing-file.ts' which doesn't exist
Solutions:
1. Create the missing file
2. Fix the import path
3. Remove the import if not needed
Check your component imports and ensure all files exist.
User prompt:
Bundle is failing with webpack errors
Diagnostics:
๐ Checking Bundle Configuration
Executing: webflow library bundle --debug-bundler
Output:
[debug-bundler] Final bundler configuration:
{
"entry": "./src/Component.tsx",
"output": {
"path": "/dist",
"filename": "bundle.js"
},
"resolve": {
"extensions": [".ts", ".tsx", ".js"]
}
}
Error: Module not found: Can't resolve 'styled-components'
โ Bundle failed: Missing dependency
Fix:
๐ Fix: Install Missing Dependency
Executing: npm install styled-components
โ Dependency installed
Retrying bundle...
Executing: webflow library bundle
โ Bundle created successfully
โ
Issue resolved
Version Check:
webflow --version
# or
webflow -V
Command Help:
webflow --help # General help
webflow library --help # Library commands help
webflow library bundle --help # Specific command help
Verbose Output:
# Add --verbose to any command for detailed debugging
webflow library bundle --verbose
webflow cloud deploy --verbose
webflow extension bundle --verbose
Debug Bundler:
# Show final bundler configuration
webflow library bundle --debug-bundler
webflow extension bundle --debug-bundler
Issue: CLI Not Found
webflow --version failsnpm install -g @webflow/cliwebflow --version shows versionIssue: Wrong CLI Version
webflow --version shows old versionnpm update -g @webflow/cliIssue: Command Not Recognized
webflow --helpIssue: Authentication Failed
webflow auth loginIssue: Build Failed
--verbose flagIssue: Bundle Configuration Error
--debug-bundler flagIssue: Missing Dependencies
npm install or install specific packageIssue: Corrupted node_modules
rm -rf node_modules && npm installCLI Not Installed:
โ Webflow CLI Not Found
Install:
npm install -g @webflow/cli
Verify:
webflow --version
Docs: https://developers.webflow.com/cli
Authentication Required:
โ Authentication Failed
Fix:
webflow auth login
Follow browser prompts to authenticate
Build/Bundle Failed:
โ Build Failed
Run with diagnostics:
webflow library bundle --verbose --debug-bundler
This shows:
- Detailed build steps
- Import resolution
- Bundler configuration
- Exact error location
Fix the errors shown in output
Unknown Error:
โ Unknown Issue
Gather info:
1. What command are you running?
2. Run command with --verbose flag
3. Check command syntax with --help
4. Share full error output
This helps identify the specific problem
Reading Config Files:
# View webflow.json
Read: webflow.json
# View package.json
Read: package.json
# View build output
Read: dist/
Discovering Files:
# Find config files
Glob: **/webflow.json
# Find components
Glob: src/**/*.webflow.tsx
# Find logs
Glob: **/*.log
Always Start With:
webflow --versionwebflow <command> --help--verbose flagFor Build/Bundle Issues:
--verbose for detailed output--debug-bundler to see configFor Authentication Issues:
webflow auth loginFor Installation Issues:
node --versionnpm install -g @webflow/cliwebflow --versionWorkflow: identify โ diagnose โ fix โ verify
Diagnostic Flags:
--version / -V - Check CLI version--help / -h - Show command help--verbose - Detailed debugging output--debug-bundler - Show bundler configCommon Fixes:
npm install -g @webflow/clinpm update -g @webflow/cliwebflow auth login--verbose output--debug-bundler outputnpm installDocumentation: https://developers.webflow.com/cli