google-docs

---
name: google-docs
description: Creates, reads, appends, and replaces Google Docs content via docs_* tools. Use for PRDs, meeting notes, and document edits when documentId is known or resolved via Drive.
---

# Google Docs

## Purpose

Create and mutate Google Docs: create with title/content, read, append at end, or replace body—using `documentId` from create or from **google-drive** search.

## When to Use

- Create a new Doc with title and optional initial content.
- Read or append to an existing Doc.
- Replace document content wholesale.

## When NOT to Use

- Finding an unknown Doc by name → **google-drive** first for `documentId`.
- Spreadsheets → **google-sheets**.
- Skill repo work → **create-skill** / **publish-skill**.

## Expected Outcome

- `documentId` returned on create and reused for subsequent ops.
- Read/append/replace confirmed from tool responses.
- No fabricated document text.

## Inputs to Gather

- `documentId` (from create or Drive).
- Title and initial content for creates.
- Append text or full replacement body as specified.

## Workflow

1. If `documentId` is unknown, use **google-drive** (`drive_search` / `drive_get_file`) to resolve it.
2. **Create**: `docs_create_document` (title, optional content) → save `documentId`.
3. **Read**: `docs_read_document` with `documentId`.
4. **Append**: `docs_append_text` at end when adding content.
5. **Replace**: `docs_replace_content` when overwriting existing content.
6. Summarize what changed; cite `documentId`.

### Domain rules

1. **Create returns documentId**—required for later calls.
2. **Append vs replace**: Append for additions; replace for full rewrites.
3. **Resolve via Drive** when the user references a doc by name only.

### Main tools

- `docs_create_document`, `docs_read_document`, `docs_append_text`, `docs_replace_content`

### Examples

**New PRD doc:** `docs_create_document` with title and first line; return link/id from response.

**Append meeting notes:** `docs_append_text` with `documentId` and user text.

## Tool Availability Rules

| Access | Behavior |
|--------|----------|
| Full tool access | Create, read, append, replace. |
| Read-only | Read only; draft writes for approval. |
| No integration | Do not fabricate document content. |

### Related tool sets

- `google-docs`

## Review / Decision / Execution Criteria

- Smallest change: append vs replace intentionally.
- Confirm large replacements with the user when appropriate.

## Output Format

1. Request and `documentId`.
2. Excerpt or confirmation from tools.
3. Errors.
4. Drive search follow-up if ID was missing.

## Quality Bar

- Preserve user wording for append/replace when given verbatim.
- Ground reads in `docs_read_document` output.

## Safety and Boundaries

- No confidential content in examples.
- Confirm destructive full replace when scope is unclear.

## Escalation / Dispatch Rules

- Missing file → **google-drive** then return here.
- No write access → output planned `docs_*` calls.

## References

- Legacy: `skills/old_skills.json` (`google-docs`).
- `skills/skill.instruction.md`, `skills/meta.instructions.md`

• SKILL.md 3 KB
• meta.yaml 1 KB