Skip to content

Conversation

@xiaolai
Copy link

@xiaolai xiaolai commented Jan 28, 2026

Summary

Add the vmark-mcp plugin - an AI writing assistant for the VMark markdown editor.

What's Included

Skill: vmark-mcp

A comprehensive skill that teaches Claude Code how to effectively use VMark's 76 MCP tools for writing assistance.

Files:

  • SKILL.md (200 lines) - Core principles, quick reference, fundamental workflow
  • references/tools-by-intent.md (264 lines) - Maps writer intents to tools
  • references/workflows.md (506 lines) - 9 detailed step-by-step patterns
  • references/examples.md (733 lines) - Real tool calls with parameters

Key Design Decisions

Decision Rationale
Writer-centric organization "Continue this thought" not "call batch_edit"
Suggestion-first Writers want collaboration, not automation
Read-before-write Always understand before modifying
Honest about limitations No real-time, no alternatives, no watching

Workflows Documented

  1. AI Writing Partner — Continue/expand at cursor
  2. Improve a Section — Refine existing content
  3. Reorganize Document — Move sections around
  4. Find and Replace — Pattern-based changes
  5. Convert Notes to Prose — Transform bullet points
  6. Multi-Document Reference — Work across tabs
  7. Format Cleanup — Batch formatting
  8. Handling Conflicts — Recover from revision errors
  9. Creating Tables — Table workflows

Links

Add AI writing assistant skill for VMark editor that provides:

- Comprehensive skill with writer-centric workflows
- tools-by-intent.md: Maps writer intents to 76 MCP tools
- workflows.md: 9 detailed step-by-step patterns
- examples.md: Real tool calls with parameters

Key features:
- Read-before-write workflow pattern
- Suggestion-first approach for content changes
- Conflict handling with revision management
- Multi-document workflow support

Homepage: https://github.com/xiaolai/vmark
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant