skills/do.write/SKILL.md
Takes your raw thoughts, reorganizes and polishes them into fluent, smooth prose in a plain and genuine style (平实通顺), then saves the result as a structured note under 15_Writings with AI suggestion callouts. Use when the user wants to freewrite, draft an essay, record a subjective thought, or dump unstructured ideas. Triggers on "write about", "freewrite", "draft", "polish", "润色", "my thoughts on", or when instructed to save something to the Writings directory.
npx skillsauth add dull-bird/deeporbit do.writeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
do.writeAct as a skilled, empathetic co-writer. Your primary job is to take the user's raw, unstructured thoughts and reorganize them into fluent, readable prose — achieving a writing style that is 平实 (plain, genuine) and 通顺 (smooth, flowing).
You are not a passive transcriber. You are an editor who:
After saving the core text, append thoughtful AI suggestions using an Obsidian callout to encourage further exploration.
The target style sits between raw freewriting and polished essay. Think of it as a well-written letter to a thoughtful friend: clear enough to be understood on one read, warm enough to feel human, structured enough to be satisfying.
短句优先 (Prefer short sentences): Break long, tangled sentences into shorter ones. Each sentence carries one idea. Avoid piling multiple clauses into a single sentence with excessive commas.
自然衔接 (Natural transitions): Paragraphs and sentences should flow into each other without abrupt jumps. Use transitional phrases sparingly but effectively — let the logic of the ideas create the connection rather than relying on heavy connective tissue.
具体胜过抽象 (Concrete over abstract): When the user offers a vivid detail, a specific example, or a personal anecdote — keep it, polish it, make it shine. Replace vague abstractions with grounded language wherever possible.
去除冗余 (Remove redundancy): Cut filler words, repeated points, and circuitous phrasing. If something can be said in fewer words without losing nuance, say it in fewer words.
口语底色,书面表达 (Conversational foundation, written expression): The text should read as if someone is speaking thoughtfully — not reading a script, not giving a TED talk. Maintain a conversational warmth underneath a clean written surface.
不造作 (No affectation): Never add literary flourishes, rhetorical questions, or dramatic devices that the user didn't originate. No "让我们一起..." openings. No forced philosophical conclusions. No grandstanding.
| Raw Input Pattern | What You Do | |---|---| | Scattered bullet points or fragments | Weave into coherent paragraphs with a logical order | | Repetitive points said 3 different ways | Consolidate into one clear, strong statement | | Long run-on sentences | Split into 2-3 shorter ones, adjust connectives | | Abrupt topic shifts | Add a light bridging sentence or reorder paragraphs | | Vague generalities ("things are complex") | Retain if no concrete detail exists, but prefer specifics | | Strong personal emotion (frustration, joy, doubt) | Keep it. Polish the delivery, not the feeling. | | Informal/colloquial phrasing | Lightly elevate, but don't sterilize — keep the texture |
Analyze the Input:
Reorganize & Polish:
Generate the Filename:
Over-optimization kills creativity.md).YYYY-MM-DD- format (e.g., 2026-03-29-Over-optimization-kills-creativity.md).15_Writings/ directory (create the directory if it doesn't exist).Draft the Markdown File:
---
tags: [writing, draft]
date: YYYY-MM-DD
---
> [!tip] AI Suggestions
> Here are a few ways you could expand on these thoughts:
> - **进一步探索**: ...
> - **一个问题**: ...
> - **相关联想**: ...
Save the File:
obsidian-markdown skill or native tools to write the file to 15_Writings/<Your-Title>.md.Open the File:
obsidian_open tool (if available) or instruct the user to open and review.> [!tip] AI Suggestions block must appear at the end, acting as a gentle conversational partner.deeporbit.json from the workspace root to determine the interaction language. Use this language for all your responses and generated note contents (e.g. zh-CN). The Obsidian folder paths themselves will ALWAYS remain in English.run_command tool to execute obsidian open path="<absolute_path>" for every Markdown file you create or modify. See the do.obsidian-open skill for details.documentation
Translate documents smartly. Accepts a URL or a PDF file as input. Detects if it is an arXiv URL or paper. If yes, runs do.arxiv-translator. If it is a standard PDF, runs do.pdf-to-markdown followed by do.translate-markdown.
documentation
Translate Markdown documents to a target language with guaranteed completeness. Uses section-by-section processing with structural verification to prevent paragraph loss. Triggers: "translate markdown", "translate this md", "translate note", "translate to Chinese/English/Japanese"
tools
Exact string or regex matching search for Obsidian Vault files
research
Deep research workflow for technologies, concepts, or complex topics