# Gitbook Common Issues

> Sub-skill of gitbook: Common Issues.

- Skill: `vamseeachanta/gitbook-common-issues` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/gitbook-common-issues`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/gitbook-common-issues/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/gitbook-common-issues

---


# Common Issues

## Common Issues


**Issue: 401 Unauthorized**
```bash
# 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**
```bash
# 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**
```python
# 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**
```markdown
<!-- Use absolute paths from root -->
![Image](/assets/image.png)

<!-- Or relative from current file -->
![Image](./images/image.png)
```