Help / Developers

Develop a FlowWrite Plugin

Start with one writing Skill, then add tools or publishing templates when the workflow needs them.

A FlowWrite Plugin can give the writing agent your own method, tool, or publishing template. The smallest useful Plugin is a single SKILL.md; no program is required.

Start with one Skill

Create a folder containing SKILL.md:

---
id: ender.scene-check
name: Scene Check
description: Check viewpoint, time, place, and character action for continuity.
---

Read the chapters selected by the user, then check:

1. Whether viewpoint changes unexpectedly.
2. Whether time and place connect naturally.
3. Whether a character knows something that has not happened yet.
4. Quote the relevant sentence and give a short suggestion for each issue.

In Settings - AI - Plugins, choose Install - Import folder, select the folder, and enable the installed Skill.

Write the Skill as direct working instructions. State the order, expected output, and things the agent must not do. A short example can clarify your standard.

Build a package

Add plugin.json when a Plugin needs multiple Skills, tools, or publishing profiles:

ender.story-tools/
  plugin.json
  skills/
    scene-check/
      SKILL.md
{
  "schemaVersion": 1,
  "id": "ender.story-tools",
  "name": "Ender Story Tools",
  "version": "1.0.0",
  "description": "Continuity tools for long-form fiction",
  "skills": ["skills/scene-check"],
  "tools": [],
  "resources": []
}

Keep id unique and use letters, numbers, dots, hyphens, or underscores. Use a semantic version such as 1.0.0 and increase it for each update. Every referenced path must remain inside the Plugin folder.

Choose the right capability

  • Skill: a method, sequence, or standard for analysis, revision, and planning.
  • Tool: an authorized command-line program or HTTPS service.
  • Publishing Profile: fields and preparation rules for a publishing destination.

Begin with a Skill. Add a Tool only when the workflow truly needs an external program or service. The current app executes supported command-line and HTTPS tools that do not require confirmation; unsupported or higher-risk tool types are not invoked.

Test and share

Import the folder, review its displayed name and version, then test it in a book with no private material. Increase the package version before reinstalling an update. Confirm that disabling the Plugin also removes its capabilities from agent tasks.

For sharing, ZIP the whole Plugin folder. Put plugin.json at the archive root or inside its only top-level folder. Explain what the Plugin can do, which permissions and services it needs, and which FlowWrite version it supports.

FlowWrite rejects malformed manifests, duplicate IDs, paths outside the package, symbolic links, and empty packages. For compatibility questions, email feedback@getflowwrite.com.