This repository contains focused skills for communication, design, and editorial review. Each skill packages the instructions and supporting references needed to apply a specific standard or review lens.

Installation

Install with the Skills CLI, then follow the prompts to choose skills and target agents:

npx skills add jakthom/skills

Communications

Executive Comms Linter

Reviews or rewrites communication from senior technical, product, and domain leaders before it is sent. It preserves substantive conclusions, authority, and directness while removing avoidable interpersonal friction, clarifying decisions and ownership, and identifying when a recurring communication problem is actually structural.

Design

Don Norman Review

Reviews products, interfaces, physical controls, and service workflows using Don Norman's The Design of Everyday Things. It diagnoses usability problems through affordances, signifiers, mappings, feedback, constraints, conceptual models, and discoverability, connecting findings to the action cycle, memory demands, error recovery, and concrete improvements.

Writing

Apache README Review

Reviews, revises, or drafts READMEs for Apache Software Foundation projects and incubating podlings. It checks project identity, installation and contribution paths, licensing references, security reporting, and applicable notices while distinguishing ASF policy requirements from project conventions and editorial recommendations.

ASD-STE100 Review

Reviews, edits, or rewrites technical documentation against ASD-STE100 Simplified Technical English. It checks controlled vocabulary, sentence and paragraph limits, procedures, descriptive text, safety instructions, terminology, punctuation, and technical fidelity while clearly separating verified compliance from an STE-oriented revision.

O'Reilly Editor Review

Reviews or revises O'Reilly book content for house style, word-list terminology, semantic formatting, and production readiness. It supports focused style questions through full-manuscript audits across prose, code, figures, tables, links, generated-AI material, and source formats such as AsciiDoc, HTMLBook, DocBook, Word, and IDML/InDesign.

Zinsser Review

Reviews, edits, or rewrites nonfiction using the craft principles associated with William Zinsser's On Writing Well. It improves clarity, simplicity, brevity, voice, organization, leads, endings, sentence rhythm, and form-specific craft without flattening the writer's personality or removing necessary meaning.