# Read Quip

> Read 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.

- Skill name: `read-quip`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/MariaSolOs/dotfiles/blob/HEAD/.pi/agent/skills/read-quip/SKILL.md
- Repository: MariaSolOs/dotfiles (576 GitHub stars when collected)

## SKILL.md

# 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:

```bash
python3 scripts/quip_read.py 'https://example.quip.com/abc123Example'
```

Useful options:

```bash
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

1. Accept a Quip URL or thread/document id from the user.
2. Load the Quip token from the environment.
3. Call `GET https://platform.quip.com/1/threads/{id}` with `Authorization: Bearer <token>`.
4. Extract `thread.title` and convert the returned `html` field to plain text unless HTML or JSON output is requested.
5. 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.

---

Source: https://www.openparable.com/skill/documents/read-quip (OpenParable). Cite the canonical URL above.