Read Quip
Documentsread-quipRead Quip is an Agent Skill for documents published in the MariaSolOs/dotfiles repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Read Quip document contents from a quip.com URL using the Quip API. Use when the user provides a Quip document URL/id and asks to read, summarize, extract, or analyze the document.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/MariaSolOs/dotfiles/blob/HEAD/.pi/agent/skills/read-quip/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/read-quip, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Read Quip
Use this skill to fetch a Quip document via the Quip API and extract readable plain text.
Requirements
A Quip API token must be available in the QUIP_API_TOKEN environment variable.
Usage
From this skill directory:
python3 scripts/quip_read.py 'https://example.quip.com/abc123Example'
Useful options:
python3 scripts/quip_read.py '<url-or-thread-id>' --output /tmp/quip.txt
python3 scripts/quip_read.py '<url-or-thread-id>' --html
python3 scripts/quip_read.py '<url-or-thread-id>' --json
Workflow
- Accept a Quip URL or thread/document id from the user.
- Load the Quip token from the environment.
- Call
GET https://platform.quip.com/1/threads/{id}withAuthorization: Bearer <token>. - Extract
thread.titleand convert the returnedhtmlfield to plain text unless HTML or JSON output is requested. - Summarize or analyze the extracted content according to the user's request.
If authentication fails, ask the user to provide/export a valid Quip token with permission to read the document.