Skip to content
Skills Library
Data & analytics · Writing

documents

/documents

Write and update Synapse documents, reports, synthesis, and Markdown figures. Use when embedding charts, plots, images, or report visuals in Synapse documents.

Repository
synapse ↗
Licence
AGPL-3.0
Last repository change
17.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 17.06.2026, without references to retired models or APIs.

Licence

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

What it does and when to use it

Write and update Synapse documents, reports, synthesis, and Markdown figures. Use when embedding charts, plots, images, or report visuals in Synapse documents.

Original author description

Write and update Synapse documents, reports, synthesis, and Markdown figures. Use when embedding charts, plots, images, or report visuals in Synapse documents.

How it works

  1. Rendering Reality
  2. Image Upload Flow
  3. Plotting Guidance
  4. Report Checklist
Original SKILL.md headings · 106 lines, 421 words
SKILL.md preview
---
name: documents
description: Write and update Synapse documents, reports, synthesis, and Markdown figures. Use when embedding charts, plots, images, or report visuals in Synapse documents.
license: AGPL-3.0
metadata:
  author: Vincentwei1021
  version: "0.8.1"
  category: research
  mcp_server: synapse
---

# Documents Skill

Use this skill when writing Synapse documents that need durable Markdown, tables, charts, plots, or embedded images. This includes experiment reports, project synthesis, deep research reports, and manually updated project documents.

## Rendering Reality

Synapse documents render Markdown. The document page supports:

- Standard Markdown images: `![caption](/api/documents/:documentUuid/images/:filename)`
- Tables via GitHub-flavored Markdown
- Simple `chart` code blocks rendered by the UI as bar or line charts

For simple numeric comparisons, prefer a `chart` block:

````
```chart
label,accuracy,loss
baseline,0.71,0.42
variant,0.78,0.36
```
````

For a line chart:

````
```chart:line
step,loss
1,0.92
2,0.73
3,0.61
```
````

Use generated image files for plots that need error bars, multi-panel layouts, confusion matrices, heatmaps, ROC/PR curves, qualitative examples, or anything the simple chart block cannot express cleanly.

## Image Upload Flow

Never embed local file paths, `data:` URLs, or third-party image hosts. Images must be uploaded to Synapse with `synapse_upload_document_image`, then referenced with the returned `url`.

For experiment reports, you may upload figures before the report document has been saved:

```text
synapse_upload_document_image({
  experimentUuid: "<experimentUuid>",
  filename: "metric-comparison.png",
  mimeType: "image/png",
  base64Content: "<base64 image bytes>"
})
```

The tool creates or reuses the dedicated experiment result document and returns:

```json
{
  "documentUuid": "...",
  "url": "/api/documents/.../images/..."
}
```

Embed the returned URL in the report Markdown, then save the report:

```markdown
![Metric comparison](/api/documents/.../images/...)
```

```text
synapse_save_experiment_report({
  experimentUuid: "<experimentUuid>",
  title: "Experiment Report: ...",
  content: "# Objective\n\n..."
})
```

For existing non-experiment documents, use `documentUuid` instead:

```text
synapse_upload_document_image({
  documentUuid: "<documentUuid>",
  filename: "synthesis-trend.png",
  mimeType: "image/png",
  base64Content: "<base64 image bytes>"
})
```

If a synthesis or deep research document does not exist yet, save a first version with the relevant save tool, read the returned document UUID, upload images with `documentUuid`, then save the final Markdown with the returned image URLs.

## Plotting Guidance

Use Python plus a plotting library when figures help interpretation. Keep plots readable in a document page:

- Use PNG for most plots; SVG is fine for diagrams and simple vector charts.
- Give every figure a useful Markdown alt/caption.
- Prefer 1-3 high-signal figures over many small plots.
- Match the report language to the project description.
- Mention the metric source and split/eval set near the figure.

## Report Checklist

Before saving a document with figures:

1. Confirm every image URL starts with `/api/documents/`.
2. Confirm no local paths, temporary hosts, or base64 data URLs remain.
3. Use `chart` blocks for small tabular numeric comparisons when that is clearer than an uploaded image.
4. Save through the task-specific document tool, such as `synapse_save_experiment_report`, `synapse_save_project_synthesis`, or `synapse_save_deep_research_report`.

Versions

RepositoryScoreLicence
This page · vincentwei1021/synapse100AGPL-3.0
magnus919/agent-skills100MIT
astrbotdevs/astrbot100AGPL-3.0
BasemTarekkamal/orbit100MIT
asgeirtj/system_prompts_leaks100CC0-1.0
virtualian/pai95MIT
virtualian/pai95MIT
virtualian/pai95MIT
virtualian/pai95MIT

Database snapshot: 13.11.2026 · package version 4383d8fd4b57 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100synapse
    Synapse platform overview and router skill. Use it to orient on projects and then hand off to the stage-specific Synapse skills.
  • 100synapse-a2a
    Synapse A2A agent communication — sending messages, spawning agents, delegating tasks, sharing memory, and coordinating file edits. Use this skill when: running synapse send/reply/broadcast/interrupt, spawning agents with synapse spawn or synapse team start, managing the task…
  • 86synapse-integration-skill
    Use when global skill for BDB Synapse (3D Codebase Visualizer) integration.
  • 95azure-synapse-analytics
    Expert knowledge for Azure Synapse Analytics development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Synapse workspaces,…
  • 100synapse-reinst
    Re-inject Synapse A2A initial instructions after context has been cleared. Use this skill when the agent has lost its identity, A2A communication protocol, or configuration after /clear or context reset, when synapse send/reply commands stop working, or when the agent no longer…
  • 95azure-synapse-analytics
    Expert knowledge for Azure Synapse Analytics development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Synapse SQL pools, Spark…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.