Analyze Document
analyze_documentRead-onlyIdempotent
Analyze the writing quality of a single document to get a summary of readability, pacing, and top issues. Focus on style, structure, themes, characters, sentiment, or pacing.
Instructions
Analyze the writing quality of a single document and return a summary of readability, pacing, and the top issues found. This is the general-purpose prose analyzer: narrow it with analysisTypes to focus on style, structure, themes, characters, sentiment, or pacing. Use check_consistency for project-wide continuity instead, or enhance_content to get rewritten prose rather than a critique. Calls an external AI model. Requires an open project and a valid document id.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| documentId | Yes | Scrivener document UUID, as returned by get_structure (a binder item "id"). | |
| analysisTypes | No | Aspects to focus the analysis on. Omit or use ["all"] for a broad analysis; otherwise pick any of readability, sentiment, themes, characters, pacing, style, structure. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issues | Yes | Craft issues found in the document. | |
| pacing | Yes | Pacing assessment of the passage (e.g. slow/steady/fast with a brief reason). | |
| readability | Yes | Readability assessment of the passage (e.g. easy/moderate/complex with a brief reason). |