Ryan Lewis ryanlewis

name

plain-technical-language

description

Draft or rewrite technical documentation in plain language, following ISO 24495-1's four principles (relevant, findable, understandable, usable). Use when the user says "plain technical language", "/plain-technical-language", "plain English", "plain language", "ISO 24495", "make this plainer", "rewrite this plainly", "tighten this doc", or asks for a README, ADR, runbook, Confluence page, ticket, or PR description to be made clearer without dumbing it down.

Plain Technical Language

Write for a competent reader in a hurry. ISO 24495-1's four principles, applied to technical docs:

name	Plain
description	Clear, plain prose — one idea per sentence, concrete verbs, no idiom, and the exact term for domain concepts

Plain writing

Write so that a reader who is skimming, tired, or reading in their second language understands it the first time. This applies to everything you produce: replies, documentation, commit messages, PR descriptions, Confluence pages, review comments.

Sentences

name

preview-markdown

description

Present a markdown file to the user in a separate terminal pane with rich rendering, instead of pasting its content into the conversation. Use when writing a tmp markdown doc for a long explanation, plan, report, or complex point, or when the user says "preview this", "show me the doc", "open it in a pane", or asks to view a markdown file alongside the terminal. Works in herdr, cmux, Ghostty (≥1.3), and iTerm2; falls back gracefully elsewhere.

Previewing markdown files in a separate pane

When presenting a markdown doc to the user — a long explanation, plan, report, or anything written to a tmp file — open it in a split pane rather than pasting the content into the conversation.

1. Detect the terminal and viewer

Adding a real 4K @ 120 Hz mode to an LG UltraGear (DP 1.4 + DSC) via EDID patch

⚠️ At your own risk. Editing an EDID can leave you with a black or green screen. It's recoverable (remove the override and/or reboot), but back up your original EDID first. No warranty, you break it you keep both pieces, etc.

The problem

LG UltraGear 4K monitors that reach 240 Hz over DisplayPort 1.4 with DSC advertise these 4K refresh rates in their DisplayID block:

3840x2160 @ 240 Hz

name

discovery

description

Interactive interview that deeply explores a plan, feature, decision, bug, architecture change, migration, or any topic until shared understanding is reached. Use PROACTIVELY when the user says "discovery", "grill me", "let's explore this", "help me think through", "what am I missing", "poke holes", "challenge this", "sanity check this", "before I start building", "flesh this out", "talk me through", "interview me about", "rubber duck this", "think this through with me", "I have an idea", "I'm thinking about", or describes a plan, decision, or approach they haven't fully explored yet. Also trigger when the user presents a half-formed idea and seems uncertain, or when they're about to jump into implementation on something that hasn't been properly examined. This skill asks probing questions across multiple dimensions — scope, constraints, edge cases, dependencies, trade-offs — until both sides have a complete, shared picture.

You are the interviewer. Your job is to ask sha

Ryan Lewis — work GPG key

For sending me encrypted things in a work context (ryan.lewis@lhv.com).

Key

Field	Value
Email	`ryan.lewis@lhv.com`
Key ID	`68A698ADACB3C08D`

Ryan Lewis — personal GPG key

For sending me encrypted things in a personal context (ryan@rlew.io).

Key

Field	Value
Email	`ryan@rlew.io` (also `ryan@wpyz.org`)
Key ID	`C4CF8705BF891FBC`

Callout Rendering Comparison

GitHub-native alerts — no titles

Note

No title — baseline.

Tip

No title — baseline.

mermaid-clip

Render a Mermaid diagram from your clipboard to a PNG image and copy it back. Useful for quickly turning copied Mermaid source into shareable images for docs, Slack, presentations, etc.

macOS only — uses pbpaste and osascript for clipboard access.

Dependencies

brew install mermaid-cli

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>From prompt to public page — Claude → Gist → gistpreview</title>
	<style>
	:root {
	--bg: #faf9f6;
	--surface: #ffffff;