Agent skill
refine
Paste any Slack message, email, or memo. It tells you what's not landing and rewrites it, tuned to who you're writing to and where it lands.
npx skills add kinantid/skillsWhat's inside
Principles
One reusable idea per file, applied where it fits, never as a checklist.
Audience playbooks
How to adapt for your CEO, cross-functional leads, peers, and customers.
Format templates
Slack, email, and customer or marketing copy.
How to use it
- Refine (the default): paste a draft and it rewrites it, with a short note on what changed and why.
- Critique: get a diagnosis of what's not landing and make the edits yourself.
- Coach: think through the strategy first, before you write a word.
Make it yours
Out of the box it writes in a neutral voice. To make it sound like you, give it samples: paste real messages or emails, drop in a screenshot of a thread, or link to an export. It learns your tone and habits from what you actually write, not from adjectives. Then:
Here are samples of how I write: emails, Slack messages, a screenshot of a thread. Rewrite the voice section to match, and never use AI prose.It saves this as a voice file inside your install. Clone-and-symlink (below) keeps it yours: it stays out of git, so updates never touch it.
The principles
A small, opinionated set. It reaches for the two or three that matter for what you're writing, not all of them at once. Each links to its original source.
- Minimum Viable Backstorystart right before you get eaten by the bear
- Signpostingreduce cognitive load
- Answer the question behind the question
- Most Obvious ObjectionMOO
- Sales, then logistics
- Accurate confidence
- How to be concise
- How to get an enthusiastic yes
- The warm nodeclining while keeping the relationship
- Managing up
- Strategy not self-expression
- Presenting to your CEO
- Right amount of context
- Turn a yellow spot into the sun
- CEDAF delegation framework
- Finessesame facts, better framing, in delicate situations
- Speak in the affirmativedo-this beats don't-do-that
- Invert the but[negative], but [positive]
- Be objective, not detachedbad news with calibrated ownership
Install
It's a standard SKILL.md skill, so it runs in Codex, Claude Code, Cursor, Gemini CLI, and other tools that read the open format. Cloning is the way to go: your voice file (above) lives in the clone, untracked, so a git pull updates the skill and never overwrites it.
git clone https://github.com/kinantid/skills.git
cd skillsCodex
ln -s "$(pwd)/skills/refine" ~/.agents/skills/refineCodex reads ~/.agents/skills and follows symlinks. Start a new chat, type $refine, and paste a draft.
Claude Code
./install.shSymlinks every skill into ~/.claude/skills. Start a new chat, paste a draft, and ask for feedback: it triggers on its own.
Just want a quick spin? Run skills.sh's npx skills add kinantid/skills, or in Codex just ask “Install the refine skill from kinantid/skills.” Switch to the clone before you build a voice file, so an update can't overwrite it.
Read the whole thing
Every principle, audience playbook, and format template lives in the repo.
These ideas come from people who think about communication for a living: Wes Kao above all, with threads from Alison Green, the military's BLUF, and others. This is our own packaging of them as a skill; sources are credited per file in the repo, and it's not affiliated with or endorsed by the original authors.