From canva-pack
Collects Canva Connect API diagnostic bundle: tests connectivity, OAuth token validity, rate limits, DNS/TLS, and environment for support tickets.
How this skill is triggered — by the user, by Claude, or both
Slash command
/canva-pack:canva-debug-bundleThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Collect diagnostic information for Canva Connect API issues. Tests connectivity to `api.canva.com/rest/v1/*`, validates OAuth tokens, checks rate limits, and packages evidence for support tickets.
Collect diagnostic information for Canva Connect API issues. Tests connectivity to api.canva.com/rest/v1/*, validates OAuth tokens, checks rate limits, and packages evidence for support tickets.
#!/bin/bash
# canva-debug.sh — Run with: bash canva-debug.sh
set -euo pipefail
TOKEN="${CANVA_ACCESS_TOKEN:-}"
BUNDLE="canva-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE"
echo "=== Canva Connect API Debug Bundle ===" | tee "$BUNDLE/summary.txt"
echo "Generated: $(date -u +%Y-%m-%dT%H:%M:%SZ)" | tee -a "$BUNDLE/summary.txt"
echo "" >> "$BUNDLE/summary.txt"
# 1. Check API reachability
echo "--- API Connectivity ---" >> "$BUNDLE/summary.txt"
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer ${TOKEN}" \
"https://api.canva.com/rest/v1/users/me")
echo "GET /v1/users/me: HTTP $HTTP_CODE" | tee -a "$BUNDLE/summary.txt"
# 2. Get user identity (if token valid)
if [ "$HTTP_CODE" = "200" ]; then
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.canva.com/rest/v1/users/me" | tee "$BUNDLE/user-identity.json" \
| python3 -m json.tool 2>/dev/null || true
echo "Token: VALID" >> "$BUNDLE/summary.txt"
else
echo "Token: INVALID or EXPIRED (HTTP $HTTP_CODE)" >> "$BUNDLE/summary.txt"
fi
# 3. Check response headers for rate limit info
echo "" >> "$BUNDLE/summary.txt"
echo "--- Rate Limit Headers ---" >> "$BUNDLE/summary.txt"
curl -s -D - -o /dev/null -H "Authorization: Bearer $TOKEN" \
"https://api.canva.com/rest/v1/designs?limit=1" 2>&1 \
| grep -iE "(x-ratelimit|retry-after|content-type|date)" \
>> "$BUNDLE/summary.txt" 2>/dev/null || echo "No rate limit headers" >> "$BUNDLE/summary.txt"
# 4. DNS resolution
echo "" >> "$BUNDLE/summary.txt"
echo "--- DNS Resolution ---" >> "$BUNDLE/summary.txt"
nslookup api.canva.com >> "$BUNDLE/summary.txt" 2>&1 || echo "nslookup not available" >> "$BUNDLE/summary.txt"
# 5. TLS check
echo "" >> "$BUNDLE/summary.txt"
echo "--- TLS Handshake ---" >> "$BUNDLE/summary.txt"
curl -sv "https://api.canva.com/rest/v1/users/me" 2>&1 \
| grep -E "(SSL|TLS|Connected)" >> "$BUNDLE/summary.txt" 2>/dev/null || true
# 6. Environment info
echo "" >> "$BUNDLE/summary.txt"
echo "--- Environment ---" >> "$BUNDLE/summary.txt"
echo "Node: $(node --version 2>/dev/null || echo 'not found')" >> "$BUNDLE/summary.txt"
echo "OS: $(uname -s -r)" >> "$BUNDLE/summary.txt"
echo "CANVA_CLIENT_ID: ${CANVA_CLIENT_ID:+[SET]}" >> "$BUNDLE/summary.txt"
echo "CANVA_ACCESS_TOKEN: ${CANVA_ACCESS_TOKEN:+[SET]}" >> "$BUNDLE/summary.txt"
# 7. Package bundle
tar -czf "$BUNDLE.tar.gz" "$BUNDLE"
echo ""
echo "Bundle created: $BUNDLE.tar.gz"
// src/canva/diagnostics.ts
interface DiagnosticResult {
check: string;
status: 'pass' | 'fail' | 'warn';
details: string;
durationMs: number;
}
async function runCanvaDiagnostics(token: string): Promise<DiagnosticResult[]> {
const results: DiagnosticResult[] = [];
// Check 1: API reachability
const start1 = Date.now();
try {
const res = await fetch('https://api.canva.com/rest/v1/users/me', {
headers: { 'Authorization': `Bearer ${token}` },
});
results.push({
check: 'API Reachability',
status: res.ok ? 'pass' : res.status === 401 ? 'fail' : 'warn',
details: `HTTP ${res.status}`,
durationMs: Date.now() - start1,
});
} catch (e: any) {
results.push({ check: 'API Reachability', status: 'fail', details: e.message, durationMs: Date.now() - start1 });
}
// Check 2: Token validity
const start2 = Date.now();
try {
const res = await fetch('https://api.canva.com/rest/v1/users/me', {
headers: { 'Authorization': `Bearer ${token}` },
});
if (res.ok) {
const data = await res.json();
results.push({
check: 'Token Validity',
status: 'pass',
details: `user_id: ${data.team_user.user_id}`,
durationMs: Date.now() - start2,
});
} else {
results.push({ check: 'Token Validity', status: 'fail', details: `HTTP ${res.status}`, durationMs: Date.now() - start2 });
}
} catch (e: any) {
results.push({ check: 'Token Validity', status: 'fail', details: e.message, durationMs: Date.now() - start2 });
}
// Check 3: Design list (tests design:meta:read scope)
const start3 = Date.now();
try {
const res = await fetch('https://api.canva.com/rest/v1/designs?limit=1', {
headers: { 'Authorization': `Bearer ${token}` },
});
results.push({
check: 'Scope: design:meta:read',
status: res.ok ? 'pass' : res.status === 403 ? 'warn' : 'fail',
details: res.ok ? 'Scope active' : `HTTP ${res.status} — scope may not be enabled`,
durationMs: Date.now() - start3,
});
} catch (e: any) {
results.push({ check: 'Scope: design:meta:read', status: 'fail', details: e.message, durationMs: Date.now() - start3 });
}
return results;
}
// Print report
const results = await runCanvaDiagnostics(process.env.CANVA_ACCESS_TOKEN!);
for (const r of results) {
const icon = r.status === 'pass' ? 'OK' : r.status === 'warn' ? 'WARN' : 'FAIL';
console.log(`[${icon}] ${r.check}: ${r.details} (${r.durationMs}ms)`);
}
ALWAYS REDACT before sharing:
Safe to include:
| Item | Purpose | Included |
|---|---|---|
HTTP status from /v1/users/me | Auth validation | Yes |
| Rate limit headers | Throttling diagnosis | Yes |
| DNS resolution | Network path | Yes |
| TLS handshake | Certificate issues | Yes |
| Environment versions | Compatibility | Yes |
For rate limit issues, see canva-rate-limits.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin canva-packDebugs Canva Connect API issues with layer tests for DNS, TLS, auth, scopes, and network tools. For intermittent failures, OAuth problems, rate limits, and support evidence.
Collects Figma API diagnostic bundle with environment info, connectivity tests, token validation, rate limits for troubleshooting and support tickets.
Collects Miro REST API v2 diagnostic bundle: environment, Node SDK version, token status, DNS/HTTPS/API connectivity tests for support tickets and troubleshooting.