shapeit: The Writing Tool That Refuses to Let a Draft Run Wild

A conversational editor that turns raw markdown into structured articles by forcing every section to justify itself.

8 min read • View on GitHub • More from Leonxlnx

A raw stack of manuscript pages is fed through a hand-cranked editorial press and emerges as a neat article with headings, lists, and pull quotes. The image explains that shapeit is not trying to write for you in one shot, but to impose structure step by step.
shapeit treats drafting like an editorial process, not a single prompt.
Key Takeaways

Most AI writing tools chase throughput. shapeit takes the opposite bet: the draft should be argued into existence, not sprayed onto the page. That makes it feel less like a text generator and more like a control surface for editorial judgment.

The tool that won’t let the model improvise too early

The interesting move here is simple. shapeit starts with raw markdown, then pushes the writer through a conversational shaping session instead of one giant prompt. Openings, sections, lists, tables, and quotes are handled as separate decisions, which keeps the model from racing ahead before the structure is sound.

The product’s intelligence lives in the sequence. Each step narrows ambiguity before the next one starts.

From raw notes to shaped prose

That sequence matters because it changes the unit of work. Instead of asking an LLM for a complete article, shapeit asks for the next editorial decision. The result is more deliberate prose, but also more accountable prose, because each paragraph has to survive a checkpoint before the next one exists.

A close-up of a rough manuscript block being carved by chisels labeled opening, paragraph, list, table, and quote. A ruler keeps the cuts aligned. The image explains how shapeit turns messy material into specific editorial forms.
The second image zooms into the mechanics of structure, not the whole workflow.

Why the repo feels opinionated instead of generic

Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step.

Leon Lin, Author/Maintainer · MCP Servers Registry - Leonxlnx

That line says almost everything. shapeit is not a blank canvas, and it is not a template dump. It behaves like an editor with standards, which is why it fits the broader anti-slop ecosystem around Leon Lin’s other skills.

ApproachHow structure appearsOpinion levelBest for
Raw ChatGPT workflowStructure arrives only if the user keeps asking for itLowFast, messy drafting
Generic prompt templateStructure is baked into a one-shot instructionMediumReusable content patterns
Vercel AI SDKYou build the workflow yourselfLow to mediumCustom AI products
shapeitStructure is negotiated step by step in conversationHighEditorial shaping under constraint

The technical shape of the system

Under the hood, the repo stays practical. It is a Next.js app, with the editor logic living in a dedicated route and the UI kept lean enough that the writing workflow stays front and center. That restraint matters: the point is not to impress with infrastructure, but to make the editorial loop feel natural.

A hedcut-style portrait of Leon Lin, the maintainer of shapeit, based on his verified GitHub avatar. The portrait grounds the project in a real creator and signals that the repo is part of a broader personal ecosystem.

The important architectural idea is not novelty, it is discipline. shapeit uses a small amount of application logic to enforce a lot of editorial intent, which is a good reminder that most AI products fail less from missing models than from missing structure.