Agent skill
gitbook-common-issues
Sub-skill of gitbook: Common Issues.
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/_archive/development/documentation/gitbook/common-issues
SKILL.md
Common Issues
Common Issues
Issue: 401 Unauthorized
# Verify token
curl -s -H "Authorization: Bearer $GITBOOK_API_TOKEN" \
"https://api.gitbook.com/v1/user"
# Regenerate token at:
# https://app.gitbook.com/account/developer
Issue: Git sync not updating
# Check Git connection in GitBook space settings
# Verify branch name matches
# Check for merge conflicts
# Force resync via API
curl -s -X POST -H "Authorization: Bearer $GITBOOK_API_TOKEN" \
"https://api.gitbook.com/v1/spaces/SPACE_ID/git/sync"
Issue: Broken links after migration
# Fix relative links
import re
content = path.read_text()
# Add .md extension to links
content = re.sub(
r'\[([^\]]+)\]\((?!http)([^)]+)(?<!\.md)\)',
r'[\1](\2.md)',
content
)
Issue: Images not displaying
<!-- Use absolute paths from root -->

<!-- Or relative from current file -->

Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
gsd-complete-milestone
Archive completed milestone and prepare for next version
gsd-reapply-patches
Reapply local modifications after a GSD update
gsd-verify-work
Validate built features through conversational UAT
gsd-thread
Manage persistent context threads for cross-session work
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?