Explain technically complicated things better.

KONVO helps you turn technical knowledge into clear, engaging educational content with AI as your editor and collaborator.

Install KONVO Open GitHub
01 / What is KONVO?

A writing skill with specific opinions.

KONVO is a portable SKILL.md that gives your AI collaborator a practical teaching playbook. You bring the expertise, examples, intent, and judgment. KONVO helps the agent inspect, organize, illustrate, and revise your work without taking over authorship.

Concrete first

Turn what you know into a system readers can picture before introducing every formal term attached to it.

Visuals with jobs

Use diagrams to show what changed, what moved, and what the system knows at each step.

Human, not mushy

Keep your rhythm, contractions, opinions, and tiny jokes without losing technical precision.

Robot habits flagged

Catch stock phrases, vague praise, and AI-shaped filler before they reach the final draft.

KONVO is tuned for people creating technical explainers across software, math, science, electronics, and engineering. Terse API references and literary criticism are happier without it.

02 / Content types

One skill. Many shapes.

KONVO works across technical content types and adjusts to the thing you are actually publishing. Use it for a deep technical walkthrough, a concise announcement, or a two-line reply without turning every job into an article.

  • Long read

    Long-form articles

    Plan the arc, sequence the teaching, and give diagrams a real job across a substantial piece.

  • Short read

    Short-form articles

    Keep the explanation compact without skipping the step readers need to follow the idea.

  • Announcement

    Press releases

    Turn technical news into a clear announcement without inventing claims or burying what changed.

  • Teach

    Explainers

    Build intuition from concrete examples before the terminology arrives, at the depth your reader needs.

  • Reply

    Chat messages

    Tighten a quick answer, preserve your voice, and stop before the response becomes an essay.

  • Post

    Social media posts

    Shape hooks, threads, platform limits, and link placement for where the work will appear.

  • And more

    The container changes. Your expertise stays.

    KONVO also works with email, forum replies, lessons, video scripts, internal write-ups, and other technical content that needs to be clear.

1,700 articles and tutorials
9 published books
15,000 forum posts and their immediate feedback
30 years of explaining hard things to real people
03 / Where it came from

Built from writing that met real readers.

KONVO is distilled from about three decades of Kirupa's published writing. The forum posts matter especially. When somebody replies confused, there is no analytics dashboard required. The explanation did not work.

The goal is not to clone one person's voice. It is to preserve the teaching moves that kept working and make them available to people using AI to create technical educational content of their own.

KONVO by the numbers

1,700 articles and tutorials
9 published books
15,000 forum posts and their immediate feedback
30 years of explaining hard things to real people
04 / Install it

Point your agent at the skill.

KONVO follows the open Agent Skills format. Clone the repository into the personal skills folder your agent watches.

The destination folder must be named konvo so it matches the name declared inside SKILL.md.

GitHub Copilot

mkdir -p ~/.copilot/skills && git clone https://github.com/kirupa/KONVO.git ~/.copilot/skills/konvo

Verify with /skills list and /skills info konvo. Reload with /skills reload.

Claude Code

mkdir -p ~/.claude/skills && git clone https://github.com/kirupa/KONVO.git ~/.claude/skills/konvo

Confirm ~/.claude/skills/konvo/SKILL.md exists, restart Claude Code, and name KONVO in a review prompt.

Codex CLI

mkdir -p ~/.agents/skills && git clone https://github.com/kirupa/KONVO.git ~/.agents/skills/konvo

Confirm ~/.agents/skills/konvo/SKILL.md exists, open a new session, and invoke the skill by name.

Cursor

mkdir -p ~/.cursor/skills && git clone https://github.com/kirupa/KONVO.git ~/.cursor/skills/konvo

Confirm ~/.cursor/skills/konvo/SKILL.md exists, restart Cursor, and ask Agent to revise with KONVO.

Installing for a project

  • GitHub Copilot: .github/skills/konvo/
  • Claude Code: .claude/skills/konvo/
  • Codex CLI: .agents/skills/konvo/
  • Cursor: .cursor/skills/konvo/

How to tell if it loaded

01 / Find the file

Confirm the agent's skill folder contains konvo/SKILL.md.

02 / Name the skill

Begin with "Use the KONVO skill to revise this draft."

03 / Watch the behavior

It should flag issues before rewriting and ask for missing context instead of guessing.

05 / Best workflow

Write the draft first. Then bring in KONVO.

KONVO can start from a blank page, but revision is where it really shines! Your draft already has your intent, taste, examples, favorite phrases, and the parts you actually care about.

  1. Write it your way

    Leave the rough transitions and unresolved bits in place. They tell the editor where the real work is.

  2. Ask for flags before fixes

    Identify weak claims, confusing jumps, missing examples, AI tells, and places where a visual would help.

  3. Review the diagnosis

    Keep changes that serve the reader. Reject edits that flatten your voice into tasteful office carpeting.

  4. Revise and read aloud

    A final human pass catches the technically legal sentence that nobody would say to another person.

This is all you need. Paste or attach your draft with this prompt, and KONVO will take it from there.

min-prompt.txt 
Use the KONVO skill to improve the draft below.

[PASTE / ATTACH YOUR DRAFT HERE]

For the best results. Paste or attach your draft with this expanded prompt. Supplying the reader, format, length, and constraints up front reduces rewrites and back-and-forth.

review-prompt.txt 
I am the author. Use the KONVO skill to
help me improve the draft below.

Goal: [WHAT SHOULD THE READER UNDERSTAND OR DO?]
Target reader: [AGE / EXPERIENCE LEVEL]
Content type / channel:
[ARTICLE / X POST / EMAIL RESPONSE / ETC.]
Target length:
[WORDS / CHARACTERS / READING TIME / POSTS]
Visuals: [PLACEHOLDERS / GENERATED / NONE]
Additional notes:
[TONE / MUST-INCLUDE / MUST-AVOID / SOURCES]

[PASTE / ATTACH YOUR DRAFT HERE]
06 / Help improve it

KONVO needs real drafts and honest feedback.

If a rule makes the writing worse, an example falls flat, or an AI-shaped phrase still slips through, bring the evidence. This skill is open so people can challenge it.

Make a suggestion or discuss a failure Submit a pull request Turn a failure into an eval