Skip to main content 首页 创作者 jeremylongshore claude-code-plugins-plus-skills webflow-debug-bundle
webflow-debug-bundle Collect Webflow debug evidence for support tickets and troubleshooting.
Gathers SDK version, token validation, rate limit status, site connectivity,
CMS health, and error logs into a single diagnostic bundle.
Trigger with phrases like "webflow debug", "webflow support bundle",
"collect webflow logs", "webflow diagnostic", "webflow troubleshoot".
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt;运行前请先检查来源。
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill webflow-debug-bundle命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地?可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... 同仓库更多 Skills Implement user sign-up and sign-in flows with Clerk.
Use when building authentication UI, customizing sign-in experience,
or implementing OAuth social login.
Trigger with phrases like "clerk sign-in", "clerk sign-up",
"clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk.
Use when managing user sessions, configuring route protection,
or implementing token refresh and custom JWT templates.
Trigger with phrases like "clerk session", "clerk middleware",
"clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management.
Use when implementing SSO integration, configuring role-based permissions,
or setting up organization-level controls.
Trigger with phrases like "clerk SSO", "clerk RBAC",
"clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
打开 GitHub 仓库 name webflow-debug-bundle description Collect Webflow debug evidence for support tickets and troubleshooting.
Gathers SDK version, token validation, rate limit status, site connectivity,
CMS health, and error logs into a single diagnostic bundle.
Trigger with phrases like "webflow debug", "webflow support bundle",
"collect webflow logs", "webflow diagnostic", "webflow troubleshoot".
allowed-tools Read, Bash(npm:*), Bash(npx:*), Bash(curl:*), Bash(tar:*), Grep version 1.5.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","design","no-code","webflow"] compatibility Designed for Claude Code
Webflow Debug Bundle
Overview
Collect comprehensive diagnostic information for Webflow integration troubleshooting.
Generates a support-ready bundle with SDK version, token status, rate limits, site
health, and redacted configuration.
Prerequisites
webflow-api SDK installed
Access to application logs
Permission to run diagnostic commands
Instructions
Step 1: Debug Bundle Script
#!/bin/bash
set -euo pipefail
BUNDLE_DIR="webflow-debug-$(date +%Y%m%d-%H%M%S) "
mkdir -p "$BUNDLE_DIR "
echo "=== Webflow Debug Bundle ===" | tee "$BUNDLE_DIR /summary.txt"
echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ) " | tee -a "$BUNDLE_DIR /summary.txt"
echo "" >> "$BUNDLE_DIR /summary.txt"
echo "--- Environment ---" >> "$BUNDLE_DIR /summary.txt"
echo "Node.js: $(node --version 2>/dev/null || echo 'not found') " >> "$BUNDLE_DIR /summary.txt"
echo "npm: $(npm --version 2>/dev/null || echo 'not found') " >> "$BUNDLE_DIR /summary.txt"
echo "OS: $(uname -s) " >>
>>
>>
>>
>>
npm list webflow-api 2>/dev/null >> || >>
>>
>>
>>
[ -n ];
HTTP_CODE=$(curl -s -o -w \
-H \
https://api.webflow.com/v2/sites 2>/dev/null)
>>
[ = ];
SITE_COUNT=$( | python3 -c 2>/dev/null || )
>>
>>
>>
curl -s -I -H \
https://api.webflow.com/v2/sites 2>/dev/null | \
grep -i >> || >>
>>
>>
>>
curl -s https://status.webflow.com/api/v2/status.json 2>/dev/null | \
python3 -c 2>/dev/null \
>> || >>
>>
>>
envfile . .env.local .env.production;
[ -f ];
>>
sed >>
>>
[ -f ] && >> || >>
>>
>>
[ -d ];
grep -ri logs/ 2>/dev/null | -50 >> ||
>>
>>
tar -czf
-rf
$(uname -r)
"$BUNDLE_DIR /summary.txt"
echo
"WEBFLOW_API_TOKEN: ${WEBFLOW_API_TOKEN:+[SET]} ${WEBFLOW_API_TOKEN:-[NOT SET]} "
"$BUNDLE_DIR /summary.txt"
echo
"WEBFLOW_SITE_ID: ${WEBFLOW_SITE_ID:+[SET]} ${WEBFLOW_SITE_ID:-[NOT SET]} "
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- SDK Version ---"
"$BUNDLE_DIR /summary.txt"
"$BUNDLE_DIR /summary.txt"
echo
"webflow-api: not installed"
"$BUNDLE_DIR /summary.txt"
echo
"Latest available: $(npm view webflow-api version 2>/dev/null || echo 'unknown') "
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- API Connectivity ---"
"$BUNDLE_DIR /summary.txt"
if
"${WEBFLOW_API_TOKEN:-} "
then
"$BUNDLE_DIR /sites-response.json"
"%{http_code}"
"Authorization: Bearer $WEBFLOW_API_TOKEN "
echo
"Sites endpoint: HTTP $HTTP_CODE "
"$BUNDLE_DIR /summary.txt"
if
"$HTTP_CODE "
"200"
then
cat
"$BUNDLE_DIR /sites-response.json"
"import sys,json; print(len(json.load(sys.stdin).get('sites',[])))"
echo
"parse error"
echo
"Accessible sites: $SITE_COUNT "
"$BUNDLE_DIR /summary.txt"
fi
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Rate Limit Status ---"
"$BUNDLE_DIR /summary.txt"
"Authorization: Bearer $WEBFLOW_API_TOKEN "
"x-ratelimit\|retry-after\|content-type"
"$BUNDLE_DIR /summary.txt"
echo
"Could not read headers"
"$BUNDLE_DIR /summary.txt"
else
echo
"Skipped (no WEBFLOW_API_TOKEN set)"
"$BUNDLE_DIR /summary.txt"
fi
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Webflow Platform Status ---"
"$BUNDLE_DIR /summary.txt"
"import sys,json; d=json.load(sys.stdin); print(f\"Status: {d['status']['description']}\")"
"$BUNDLE_DIR /summary.txt"
echo
"Could not reach status page"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Config (redacted) ---"
"$BUNDLE_DIR /summary.txt"
for
in
env
do
if
"$envfile "
then
echo
"[$envfile ]"
"$BUNDLE_DIR /config-redacted.txt"
's/=.*/=***REDACTED***/'
"$envfile "
"$BUNDLE_DIR /config-redacted.txt"
echo
""
"$BUNDLE_DIR /config-redacted.txt"
fi
done
"$BUNDLE_DIR /config-redacted.txt"
echo
"See config-redacted.txt"
"$BUNDLE_DIR /summary.txt"
echo
"No .env files found"
"$BUNDLE_DIR /summary.txt"
echo
""
"$BUNDLE_DIR /summary.txt"
echo
"--- Recent Errors ---"
"$BUNDLE_DIR /summary.txt"
if
"logs"
then
"webflow\|429\|401\|403\|500"
tail
"$BUNDLE_DIR /errors.txt"
true
echo
"See errors.txt"
"$BUNDLE_DIR /summary.txt"
else
echo
"No logs/ directory found"
"$BUNDLE_DIR /summary.txt"
fi
"$BUNDLE_DIR .tar.gz"
"$BUNDLE_DIR "
rm
"$BUNDLE_DIR "
echo
""
echo
"Bundle created: $BUNDLE_DIR .tar.gz"
echo
"Review for sensitive data before sharing."
Step 2: TypeScript Diagnostic Script For deeper programmatic diagnostics:
import { WebflowClient } from "webflow-api" ;
interface DiagnosticReport {
timestamp : string ;
sdk : { version : string ; installed : boolean };
auth : { valid : boolean ; error ?: string };
sites : Array <{ id : string ; name : string ; lastPublished : string | null }>;
collections : Array <{ siteId : string ; id : string ; name : string ; itemCount : number }>;
rateLimits : { note : string };
platformStatus : string ;
}
async function runDiagnostics ( ): Promise <DiagnosticReport > {
const report : DiagnosticReport = {
timestamp : new Date ().toISOString (),
sdk : { version : "unknown" , installed : false },
auth : { valid : false },
sites : [],
collections : [],
rateLimits : { note : "Check response headers for X-RateLimit-Remaining" },
platformStatus : "unknown" ,
};
try {
const pkg = await import ("webflow-api/package.json" , { assert : { type : "json" } });
report.sdk = { version : pkg.default .version , installed : true };
} catch {
report.sdk = { version : "unknown" , installed : true };
}
const webflow = new WebflowClient ({
accessToken : process.env .WEBFLOW_API_TOKEN !,
});
try {
const { sites } = await webflow.sites .list ();
report.auth = { valid : true };
report.sites = (sites || []).map (s => ({
id : s.id !,
name : s.displayName !,
lastPublished : s.lastPublished || null ,
}));
for (const site of sites || []) {
const { collections } = await webflow.collections .list (site.id !);
for (const col of collections || []) {
report.collections .push ({
siteId : site.id !,
id : col.id !,
name : col.displayName !,
itemCount : col.itemCount || 0 ,
});
}
}
} catch (err : any ) {
report.auth = { valid : false , error : `${err.statusCode} : ${err.message} ` };
}
try {
const res = await fetch ("https://status.webflow.com/api/v2/status.json" );
const data = await res.json ();
report.platformStatus = data.status ?.description || "unknown" ;
} catch {
report.platformStatus = "unreachable" ;
}
return report;
}
runDiagnostics ().then (report => {
console .log (JSON .stringify (report, null , 2 ));
}).catch (console .error );
Step 3: Run Diagnostics
chmod +x webflow-debug-bundle.sh
./webflow-debug-bundle.sh
npx tsx webflow-diagnostics.ts
Sensitive Data Handling ALWAYS REDACT before sharing:
API tokens and OAuth secrets
Customer emails and PII from form submissions
Webhook secrets
HTTP status codes and error messages
SDK/Node.js versions
Site IDs and collection IDs (not sensitive)
Rate limit headers
Platform status
Output
webflow-debug-YYYYMMDD-HHMMSS.tar.gz archive containing:
summary.txt — Environment, SDK version, connectivity, rate limits
sites-response.json — API response (if token valid)
config-redacted.txt — Environment files with values masked
errors.txt — Recent error logs
Error Handling Issue Cause Solution curl: command not foundcurl not installed apt install curl or use TypeScript diagnosticsSites endpoint 401 Token expired Generate new token Status page unreachable Network issue Check DNS/firewall Empty error logs No logs/ directory Check app logging configuration
Resources
Next Steps For rate limit issues, see webflow-rate-limits.