u/mxriverlynn

just said that to me girlfriend, at a clothing store, when she said she needed to try something on 🤦🏼‍♀️🤣

i built a /pairing skill for Claude, today. the intent is the put Claude into a collaborative work mode where it tells you what it's gonna do, asks for feedback or approval, does it, waits for feedback, then goes on to the next step

is sounds pretty simple. but it took a lot of cycles to get it working pretty well.

that said, I'd love to get some feedback from anyone who wants to run Claude in a collaborative, pairing mode like this!

link to the main repo: https://github.com/testdouble/han

link to the docs for this skill: https://github.com/testdouble/han/blob/main/han-core/docs/skills/pairing.md

install the core plugin to get this skill:

 /marketplace add han@testdouble

 /plugin install han-core@han

and here's a few sample prompts to try, or use as examples to write your own prompt:

• pair with me on refactoring {some code or method, etc} to make it {some stated goal}

• pair with me on implementing the feedback from {PR link or screenshot}

• pair with me on implementing {work ticket link} with TDD

if you also have the han-coding plugin installed, it should run the /tdd skill or /refactor skill with those prompt examples, in this collaborative mode.

i've love to get real feedback on how well this works or doesn't work! reply here, dm me, or post an issue in the GitHub repo.

last week, i shared my readability plug-in, the 3 skills and 1 custom agent it comes with. several people asked about using a custom output style instead of skills. i looked into it forget and it turns out you can ship an output style with a plug-in. so I've done exactly that with the latest release of han-communication. the skills and custom agent also let you set up your own writing-style.md document, so you can customize the output

Han-Communication (link to readme and docs)

• /readability-guidance - skill to load guidance into context and apply it to output, for general text

• /explanation-guidance - skill to load guidance into context and apply it to technical explanations

• /edit-for-readability - skill to edit any existing text, improving readability

• readability-editor - a custom agent that uses reference materials to do readability editing work

• Han Readability - a custom output style that distills all the guidance into an output style for Cluade to use

install:

/marketplace add testdouble/han
/plugin install han-communication@han

set the output style:

/config - go down to output style, and select "Han Readability"

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