# Send Dizest Summarize to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dizest-summarize",
    "name": "Dizest Summarize",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/s-annam/dizest-summarize",
    "canonicalUrl": "https://clawhub.ai/s-annam/dizest-summarize",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/dizest-summarize",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dizest-summarize",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "dizest-summarize",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T15:50:10.526Z",
      "expiresAt": "2026-05-09T15:50:10.526Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dizest-summarize",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dizest-summarize",
        "contentDisposition": "attachment; filename=\"dizest-summarize-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "dizest-summarize"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/dizest-summarize"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dizest-summarize",
    "downloadUrl": "https://openagent3.xyz/downloads/dizest-summarize",
    "agentUrl": "https://openagent3.xyz/skills/dizest-summarize/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dizest-summarize/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dizest-summarize/agent.md"
  }
}
```
## Documentation

### Dizest Summarize

Summarize long-form content and turn it into structured, searchable knowledge. Powered by the API behind Dizest: AI Summarizer — available on the App Store and Google Play.

Base URL: https://api.dizest.ai

Visit www.dizest.ai for more information about the product.

### When to Use This Skill

Use this skill when the user asks to:

Summarize research papers or academic content to extract key findings
Summarize long podcasts, interviews, or video content from YouTube and other platforms
Process articles, blog posts, or web content (by URL)
Summarize PDFs, reports, market analysis, or business documents
Summarize plain text such as notes, transcripts, or pasted content
Summarize any of the above with a custom focus (e.g., "focus on methodology and key findings")

### Critical Agent Behavior

The agent MUST act as a thin client. Specifically:

Do NOT extract, parse, or classify URLs from the user's input.
Do NOT attempt to determine whether the input is a URL, plain text, or text with an embedded URL.
Do NOT fetch, scrape, or pre-process any content before calling the API.
Do NOT handle paywalled content or attempt workarounds.

All content analysis, URL detection, extraction, paywall handling, and execution logic is performed server-side. The agent's only job is to forward the user's input to the API exactly as provided.

### Authentication

All requests require the x-api-key header. The value should come from the DIZEST_API_KEY environment variable.

x-api-key: $DIZEST_API_KEY

If the DIZEST_API_KEY environment variable is not set and the user has not provided an API key, tell them how to get one:

Download Dizest from dizest.ai — available on iOS, Android, and macOS (coming soon)
Create an account and sign in
Activate your account through the app (one-time setup)
Generate your API key at dizest.ai/api/keys — sign in with the same account

Account activation through the app is required to generate API keys. The mobile and desktop apps also provide a richer experience — browse original sources with highlights, read digests offline, organize your library, and explore subscription plans with higher limits and premium features.

### API Flow

There are two steps: create an execution, then retrieve the results.

### Step 1: Create Execution

Endpoint:

POST https://api.dizest.ai/v1/summarize

Headers:

Content-Type: application/json
x-api-key: $DIZEST_API_KEY

Request Body (minimal):

{
  "content": "<user input>"
}

Request Body (with custom instructions):

{
  "content": "<user input>",
  "custom_instructions": "<what to focus on>"
}

Request Body (with output language):

{
  "content": "<user input>",
  "output_language": "ja"
}

Pass the user's input directly as the content value. Do not modify, parse, or pre-process it.

Request Fields:

FieldTypeRequiredDescriptioncontentstringYesThe user's input to summarize. Pass as-is without modification.custom_instructionsstringNoFocus instructions for the summary (e.g., "focus on key findings").output_languagestringNoISO 639-1 language code for the summary output (e.g., "ja", "es"). Defaults to "en".

Response:

{
  "execution_id": "b7e2c1a4-93f1-4d2a-8e56-1a2b3c4d5e6f",
  "cached": false
}

FieldTypeDescriptionexecution_idstringUUID identifying this execution. Used to retrieve results.cachedbooleantrue if result was cached and is ready immediately.

### Step 2: Retrieve Results

Use the execution_id from Step 1 to retrieve the summary. There are two methods.

Preferred: Server-Sent Events (SSE) Stream

GET https://api.dizest.ai/v1/executions/<execution_id>/events

Headers:

x-api-key: $DIZEST_API_KEY

The server responds with a stream of Server-Sent Events. Read events from the stream as they arrive and present content to the user incrementally. The stream closes when the execution is complete.

Fallback: JSON Polling

Note: The polling endpoint is not yet available. SSE is the only supported retrieval method in v1. This section will be updated when polling support is added.

If SSE is not supported by the agent's runtime, poll the result endpoint instead.

GET https://api.dizest.ai/v1/executions/<execution_id>/result

Headers:

x-api-key: $DIZEST_API_KEY

Poll this endpoint at reasonable intervals (e.g., every 2–3 seconds) until the result is available. The response is a JSON object containing the final summary.

### Example 1: Summarize a URL

User says: "Summarize https://example.com/article-about-ai"

POST /v1/summarize

{
  "content": "https://example.com/article-about-ai"
}

### Example 2: Summarize Text with an Embedded URL

User says: "Can you summarize this for me? I found it interesting: https://example.com/post/12345"

POST /v1/summarize

{
  "content": "Can you summarize this for me? I found it interesting: https://example.com/post/12345"
}

Forward the entire input as-is. Do not extract the URL.

### Example 3: Summarize Plain Text

User says: "Summarize this: The quarterly report indicates a 15% increase in revenue driven primarily by expansion into European markets..."

POST /v1/summarize

{
  "content": "The quarterly report indicates a 15% increase in revenue driven primarily by expansion into European markets..."
}

### Example 4: Summarize a Podcast or Video

User says: "Summarize this podcast https://www.youtube.com/watch?v=dQw4w9WgXcQ"

POST /v1/summarize

{
  "content": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

### Example 5: Custom Instructions

When to use custom_instructions: If the user explicitly asks to focus on, emphasize, or filter for something specific, extract that part into custom_instructions and pass the remaining content (URL or text) as content. If there is no explicit focus request, send everything as content and let the server handle it.

User says: "Summarize https://example.com/research-paper but focus on the methodology and key findings"

POST /v1/summarize

{
  "content": "https://example.com/research-paper",
  "custom_instructions": "Focus on the methodology and key findings"
}

### Output Expectations

The API returns a summary generated server-side.
Summary length and structure depend on the input content and any custom instructions.
Present the summary to the user as-is. Do not further condense or reformat unless the user requests it.

### Troubleshooting

ProblemCauseResolution401 UnauthorizedMissing or invalid x-api-key header.Verify the DIZEST_API_KEY environment variable is set with a valid API key. API keys require an activated Dizest account — see the Authentication section above for setup steps.403 ForbiddenThe API key does not have access.Confirm the key belongs to an activated account.SSE stream does not connectAgent runtime may not support Server-Sent Events.Fall back to polling GET /v1/executions/<execution_id>/result.Polling returns no resultThe execution is still processing.Continue polling every 2–3 seconds. Allow sufficient time for longer content.Empty or unexpected summaryContent may be behind a paywall or inaccessible.Inform the user. Do not attempt client-side workarounds — the server handles extraction.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: s-annam
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T15:50:10.526Z
- Expires at: 2026-05-09T15:50:10.526Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/dizest-summarize)
- [Send to Agent page](https://openagent3.xyz/skills/dizest-summarize/agent)
- [JSON manifest](https://openagent3.xyz/skills/dizest-summarize/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/dizest-summarize/agent.md)
- [Download page](https://openagent3.xyz/downloads/dizest-summarize)