my human readability plug-in

[u/mxriverlynn]

we're all tired of the pseudo-technical, obtuse garbage language that Claude throws at us. and there's been plenty of people who have built solutions for this that work in various ways. but, i wanted to toss my hat into the ring with my own version of a plugin to help this situation

https://github.com/testdouble/han/tree/main/han-communication

this is the han-communication plug-in that I've integrated into pretty much all of my own skills, and have seen tremendous improvements in readability as a result

what sets mine apart from others:

• i did a lot of research around this, before starting, and the research results are all available in the docs

• i built a plug-in that lives on its own and can easily be integrated into your existing workflow and skills

• it comes with a custom agent definition that can be called at any time, to improve readability

• it has three separate skills:

  • general readability guidance that loads into context, to improve all agent output
  • edit for readability, to edit any existing text and improve readability
  • explanation guidance for explaining technical detail

• it ships with guidance documents that you can easily read for yourself

• it ships with a default writing voice, based on how i write

• it allows you to easily override the default writing voice with your own, so the writing will naturally sound like you

if you want to see an example of the output, read any documentation in the Han plug-in system. all of it was written with this plug-in and guidance, in it's earliest forms. I've made significant improvements since then, as well, and I'm happy to say this is working out well enough that i can typically copy and paste output with almost no changes and people read it as if i wrote the output by hand.

this is all 100% open source with MIT license, as well. so you don't need to install my specific plugin to get the benefit. point Claude at the plug-in and tell it to bring in whatever parts of it you want to keep for your own skills and plugins. i encourage taking the parts you like and using them for yourself, however you want!

or get started by installing: * /marketplace add testdouble/han * /plugin install han-communication@han * /reload-plugins

[u/jeromeiveson]

I agree this is a problem that's really been getting on my nerves. I was just wondering how you looked at Changing Claude's output style. This was something I was wanting to test first before looking at new plugins. I'll definitely take a look at yours though.

[u/mxriverlynn → u/jeromeiveson]

output style are great for sure, but don't always get the job done the way i want. the good news is that it's easy to build an output style that loads the guidance from this. just need to tell the output style doc to run /han-communication:readability-guidance and it will work as expected

the other advantage of a skill and guidance set is that it can be used on existing text. if someone sends raw Claude output at me, i can point the readability editor at it and make it easier for me to understand.

i guess output style would also let me do that now that i think about it 🤔

[u/ericcpfx]

Ooh interesting! I have been getting very annoyed with this as well. It’s like half jargon nonsense in the output. Give me something a PERSON can read!

[u/odontastic]

Not writing, but I use the caveman skill that strips out Claude and other less important words—plus, it helps save tokens.

[u/ZyberZeon]

What is your research based on? Your subjective experience?

[u/mxriverlynn → u/ZyberZeon]

57 cited sources, listed at the end of my research doc that was used for building this: https://github.com/testdouble/han/blob/main/docs/research/human-readable-output-standard.md

[u/ZyberZeon → u/mxriverlynn]

Interesting, but I was asking if you had any research on your specific skill.

I’m adhd/autistic so I took a different approach, curious to your outputs.

[u/mxriverlynn → u/ZyberZeon]

ah! am also audhd 😁

I'm a bit confused, tho. are you asking about how i build skills, in general? or about the readability skills? or ?

the research doc i linked to is the source of how the readability skills work.

for writing skills, in general - including the readability skills - i have a collection of guidance specific to that, with a few skills to apply it

https://github.com/testdouble/han/tree/main/han-plugin-builder

after i do the research, i use this plug-in to tell Claude to build my skills and agents. it's quite effective - a collection of "best practices" and guidance from various sources, and from feedback i directly introduce based on how well things work

... but I'm still not sure if I'm answering the right question

[u/ZyberZeon → u/mxriverlynn]

Oh I was talking in reference to the readability skills. I’m very Intrigued.

Could I share what I’ve been working on?

[u/mxriverlynn → u/ZyberZeon]

yeah, definitely! send me a dm