$npx -y skills add aws-samples/sample-agent-skills-for-builders --skill quip-to-gitlab-wikiMigrate Quip documents to GitLab Wiki with full content preservation. Use when converting Quip docs to wiki, migrating documentation, or setting up GitLab wiki from Quip sources.
| 1 | # Quip to GitLab Wiki Migration |
| 2 | |
| 3 | Migrate Quip documents to GitLab Wiki with full content and media preservation. |
| 4 | |
| 5 | ## When to Apply |
| 6 | |
| 7 | Reference this skill when: |
| 8 | - Migrating Quip documents to GitLab |
| 9 | - Converting documentation to wiki format |
| 10 | - Preserving embedded images and videos |
| 11 | - Setting up GitLab wiki structure |
| 12 | |
| 13 | ## How It Works |
| 14 | |
| 15 | 1. **Gather Sources** - Collect Quip URLs and tokens |
| 16 | 2. **Convert** - Transform Quip HTML to Markdown |
| 17 | 3. **Push** - Upload to GitLab Wiki |
| 18 | 4. **Configure** - Set up GitLab MCP for future edits |
| 19 | 5. **Structure** - Organize wiki navigation |
| 20 | |
| 21 | ## Prerequisites |
| 22 | |
| 23 | - Quip API token |
| 24 | - GitLab project with wiki enabled |
| 25 | - Python 3.8+ with html2text |
| 26 | - ffmpeg (for video compression) |
| 27 | |
| 28 | ## Usage |
| 29 | |
| 30 | ```bash |
| 31 | # Convert Quip document (token from environment) |
| 32 | export QUIP_TOKEN="your_token_here" |
| 33 | python scripts/quip-to-markdown.py <thread_id> <output_dir> |
| 34 | |
| 35 | # Push to GitLab wiki |
| 36 | ./scripts/push-to-wiki.sh <wiki_git_url> <content_dir> <page_path> <quip_url> |
| 37 | ``` |
| 38 | |
| 39 | ## Conversion Features |
| 40 | |
| 41 | - HTML to Markdown via html2text |
| 42 | - Embedded image download |
| 43 | - Video compression (MOV→MP4 at 720p) |
| 44 | - Asset organization in `uploads/` |
| 45 | |
| 46 | ## Wiki Structure |
| 47 | |
| 48 | ``` |
| 49 | wiki/ |
| 50 | ├── Home.md |
| 51 | ├── Section-Name/ |
| 52 | │ ├── _index.md |
| 53 | │ └── Page-Name.md |
| 54 | └── uploads/ |
| 55 | ├── image1.png |
| 56 | └── video1.mp4 |
| 57 | ``` |
| 58 | |
| 59 | ## Image Path Rules |
| 60 | |
| 61 | | Page Location | Image Path | |
| 62 | |--------------|------------| |
| 63 | | Root pages | `uploads/image.png` | |
| 64 | | Section pages | `../uploads/image.png` | |
| 65 | | Nested pages | `../../uploads/image.png` | |
| 66 | |
| 67 | ## References |
| 68 | |
| 69 | - [GitLab MCP Configuration](./references/gitlab-mcp-config.md) |