style

Applies Justin's personal writing voice to PRs, docs, reviews, and Slack messages.

Updated Oct 16, 2025
One-click install
npx skills add https://github.com/jlui17/dotfiles --skill style-jlui17
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: style
Source: https://github.com/jlui17/dotfiles/tree/main/agents/skills/style
Command: npx skills add https://github.com/jlui17/dotfiles --skill style-jlui17

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing that ships under Justin's name must match his voice: lean, plain, behavior-first, and skimmable. This Skill encodes that voice as concrete rules so drafts of PR descriptions, design docs, reviews, and messages read as his without manual rewriting. ## Core Features & Use Cases - Voice rules: Enforces lean prose, plain wording, cold-reader definitions, behavior-first framing, and confidence-with-assumption statements across every artifact. - Per-register guides: Dedicated references for tech plans, PR descriptions, change walkthroughs, design critiques, reports, visual artifacts, and Slack messages, each with its own density and schema. - Use Case: Before posting a PR description, apply the skill to rewrite a mechanism-heavy draft into a behavior-first, one-page body with a plain-English problem statement and grouped verification claims. ## Quick Start Use the style skill to rewrite this PR description in Justin's voice before I post it.

Frequently Asked Questions about style

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a PR description in a specific personal voice?▼

Apply the style skill before drafting: it leads with the current behavior and conceptual fix in plain English, keeps the body to one page, and cuts anything readable straight from the diff. The pr-descriptions reference defines the full arc from problem through verification.

How to write a design doc or tech plan that stays short?▼

The tech-plans reference wins length through density, not omission: define terms inline at first use, open each section with one framing line, and include only current-behavior facts the design leans on. Decision history moves to PR history, replaced by one pointer line.

What writing rules does this style skill enforce?▼

It enforces lean prose with short paragraphs, plain declarative wording, cold-reader definitions for every identifier, behavior-first framing of changes, and confidence stated with its assumption. Bold marks one load-bearing claim per paragraph; em-dashes are a last resort.

Does the style change for Slack messages versus PR descriptions?▼

Yes, the voice stays constant but density changes per register. Slack messages are casual and conversational with one link and few identifiers, while PR descriptions are formal, behavior-first, and budgeted to one page. Each register has its own reference file.

When should wording feedback be applied to a draft?▼

Wording feedback goes into the artifact immediately, never noted for later. A dictated replacement lands verbatim, then its shape generalizes to the rest of the artifact. Design decisions are the opposite: discuss and confirm first, then apply.