Skip to content

Show HN: I built a skill, grounded in research, to make your writing less boring

github.com/ericfitz
1 pointefitzdiscuss
On HN

My job at a large tech company requires me to write. A lot. Mainly I write docs to help align technical people on a technical strategy, or to inform executives about technical matters, or to make requests of executives about technical proposals.

I wanted to ensure that my writing was captivating and that the audience didn't just read the summary and skip the rest.

I used a chat agent to build a research report on the academic literature about what makes writing boring or not-boring ("not-boring" is NOT the same thing as "interesting"). I synthesized that into a taxonomy, and built tooling for mechanistic analysis and prompts for LLM analysis, synthesis and recommendation.

What this is: research-grounded analysis of a document with concrete evidence-based suggestions of how to improve it.

What this is NOT: it's not a simplistic prompt "Help me make my document better" or even "make every section/paragraph/sentence earn its place". (I am developing a separate skill for that in the same repo, but with a much more diligent approach).

I hope this helps you improve your own writing and effectiveness in business communication.

Comments

No comments yet.

AboutSource Built by g1lg1l

Hackerly is an independent reader for Hacker News, built on the public HN API. Not affiliated with Y Combinator.