Skip to content
Skills Library
Data & analytics · Conversion & formats

export-map

/export-map

Export the current Gephi map as a clean PNG, labeled PNG, and SVG after checking that it is laid out, styled, and visually valid. Use for publication-ready map export and caption handoff.

Repository
gephi-ai ↗
Licence
Apache-2.0
Last repository change
12.10.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 12.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Export the current Gephi map as a clean PNG, labeled PNG, and SVG after checking that it is laid out, styled, and visually valid. Use for publication-ready map export and caption handoff.

Original author description

Export the current Gephi map as a clean PNG, labeled PNG, and SVG after checking that it is laid out, styled, and visually valid. Use for publication-ready map export and caption handoff.

How it works

  1. Rules this workflow must keep
  2. Steps
  3. Important
Original SKILL.md headings · 82 lines, 792 words
SKILL.md preview
---
name: export-map
description: Export the current Gephi map as a clean PNG, labeled PNG, and SVG after checking that it is laid out, styled, and visually valid. Use for publication-ready map export and caption handoff.
---

# Export Map

Export the map currently open in Gephi: a clean PNG, a labeled PNG, an SVG, a
legend when colour encodes groups, and a copy-ready caption. This workflow
exports; it does not lay out or style. The map has to be a map first (laid out,
sized, colored), which the `visualize-network` workflow does.

Follow the `gephi` skill's rules throughout; this workflow repeats only the ones
it is most likely to break.
Read `../gephi/references/reading-network-maps.md` for
the caption discipline.

**Tell the user what you are doing at each step.** Narrate briefly before each tool call so they know what is happening.

## Rules this workflow must keep

- **Asking.** When a step says to ask, ask once. If the person cannot answer, is away, or asked for a finished product, use the default named in that step and remove or overwrite nothing. At the end, give one short line for each choice that changed the result, under "Choices I made"; leave the section out when every step used its obvious default. If there is no input to work on, stop and say what is needed.
- **Session start.** Start with `gephi_health_check`. Then check which workspace is open (`gephi_list_workspaces`) and whether a filter is active (`filter_active` in replies): a filter from an earlier conversation stays on, and exports and checks then see only what it shows.
- **Caption and legend.** Every export ships with a copy-ready caption (data, layout and settings, what size and colour encode, what the map does and does not show) and, when colour encodes groups, a legend (`gephi_export_legend`).
- **Edges.** On a light background, edges use `{"edge.color": "#D0D0D0", "edge.opacity": 90, "edge.thickness": 1.0, "edge.curved": false}`. Label settings change labels only; they never reset edge values.

## Steps

1. **Session start**: Call `gephi_health_check`. If it fails, tell the user to start Gephi and stop. Call `gephi_list_workspaces` and `gephi_get_project_info`. Tell the user the node and edge counts and which workspace will be exported. If the graph is empty, stop and tell them. If `filter_active` is true, say that the export will show only the visible nodes, and put that in the caption.

2. **Is it a map yet?** Call `gephi_visual_qa` (with the partition column if the
   graph has one). If its `warnings` include the "looks untouched" warning, or
   `sizes.flat` is true and `colors.distinct` is 1, the graph has been loaded
   but not laid out or styled: exporting at this point produces the block of overlapping
   default nodes. Say that, and offer the recommended path: use `visualize-network`
   (layout, sizes, colors, with a visual check) and then export. Ask once
   whether to export anyway. Default: do not export an untouched graph; stop
   and say that `visualize-network` comes first. If `visual_qa` returns other warnings
   (invisible sizes, near-white colors, an exploded layout), fix or flag them
   before exporting.

3. **Choose the path.** Use the path given in the request. Default: `~/Desktop/network.png`, with the other files beside it.

4. **Set preview settings for clean export** (no labels). Call `gephi_set_preview_settings` with:
   ```json
   {
     "node.label.show": false,
     "edge.opacity": 90,
     "edge.curved": false,
     "edge.color": "#D0D0D0",
     "edge.thickness": 1.0,
     "node.opacity": 100,
     "node.border.width": 0.3,
     "arrow.size": 0
   }
   ```
   Tell the user: "Setting preview to clean mode: no labels, light gray edges."

5. **Export clean PNG**: Call `gephi_export_png` with `file` set to the chosen path, at `width: 3840, height: 2160`.
   Tell the user: "Exporting clean PNG at 4K resolution..."

6. **Enable labels and export annotated version**:
   - Call `gephi_set_preview_settings` with label settings only, so the edges keep the values from step 4:
     ```json
     {
       "node.label.show": true,
       "node.label.proportinalSize": false,
       "node.label.font": "Arial 10 Plain",
       "node.label.outline.size": 4,
       "node.label.outline.opacity": 95
     }
     ```
   - Export with a `_labeled` suffix. Tell the user: "Exporting labeled version..."

7. **Export SVG**: Call `gephi_export_svg` with `file` set to the same base path with the `.svg` extension.
   Tell the user: "Exporting SVG for vector editing..."

8. **Export the legend** when colour encodes groups: call `gephi_export_legend` with `file` set to the same base path with a `_legend.svg` suffix (the legend is an SVG). It refuses when no colour or size mapping was applied through these tools in this session; then say so and name the colours in the caption instead. If the legend shows numbers rather than names, say so, and suggest writing the earned names to a column and colouring by that column.

9. **Report**: List every exported file path clearly, then give the copy-ready caption: the data, the layout and its key settings, what node size and colour encode, and what the map does and does not show (including any active filter). End with "Choices I made" only for choices that changed the result.

## Important

- The export tools use `file` as the parameter name for the output path, not `path`
- If any export fails, report the error and continue with remaining exports

Versions

The database has no other skills named export-map.

Database snapshot: 13.11.2026 · package version cda4d081fdcb (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

  • 90visualize-network
    Turn the graph currently open in Gephi into a clean, legible, publication-ready map through a measured layout, visual-QA, inspection, and adjustment loop. Use for visualize, lay out, style, make this readable, or make this publication-ready.
  • 100gephi
    Load before the first gephi_ tool call in any session. Use when someone asks to build, import, analyze, style, lay out, filter, teach from, compare over time, or export a network in Gephi, or asks who matters most, which groups exist, whether a claim about a network holds, or…
  • 90export-diagram
    Export a generated aws-diagram-design HTML diagram to .svg and/or .png next to the source. Use when the user asks to export, save, rasterize, convert, or download a diagram as PNG or SVG. Korean triggers: PNG로 내보내기, SVG로 저장, 다이어그램 이미지로 변환.
  • 95export-schedule
    课表图片导出技能(独立包,本地渲染)。把课表渲染成图片文件——第 N 周课表或 整学期汇总,PNG/SVG,红头档案或彩色课格两种风格。当用户说「导出课表」 「导出课表图片」「把课表导出来」「本周/这周课表图」「第 N 周课表图片」 「整学期课表图」或任何想要课表图片文件的场景时使用。零登录零网络, 从本地课表缓存直接渲染。
  • 91export-project
    Export an .infragram.json infrastructure project, or an exported SVG, PNG or page that carries one, to HTML, SVG and PNG, and on request its Azure Terraform skeleton. Run when the user invokes it with a document or picture.
  • 100export-handoff
    Export Design work and produce developer handoff materials. Use when the user wants HubSpot email HTML, PNG, SVG, ZIP/code exports, implementation notes, or a coding handoff for a selected design.

Feedback and reports

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