Swyx Writing

Apply swyx's reusable nonfiction writing preferences when drafting or materially revising prose, including technical posts, essays, research memos, reports, documentation, profiles, scripts, announcements, and publishing copy. Use as the shared style and editing layer alongside the skill that owns the subject or format. Do not use for verbatim transcription, code-only work, or fiction unless the user explicitly asks for swyx's nonfiction voice.

201 stars 12 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add swyxio/skills --skill swyx-writing
Manual install
git clone --depth 1 https://github.com/swyxio/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/swyx-writing ~/.claude/skills/swyx-writing

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# swyx writing

Write so a smart reader can understand the point once, remember the useful
model, and decide what to do next. Preserve the author's real judgment and the
messiness that earned it. Do not imitate a generic founder, marketer, or
technical-blog persona.

This skill owns voice, explanation, and editing. Pair it with the skill that
owns the facts or format:

- use `research-grounded-writing` when claims require external or primary
  evidence;
- use `ai-devblog` for technical story selection and publication;
- use `ai-readme` for executable repository documentation;
- use `person-profile-writing` for biographies and identity research;
- use `video-talk-to-essay` for recorded-talk articles.

The genre skill decides what belongs. This skill decides how the prose reads.

## Start with the reader's change

Before substantial drafting, identify privately:

- what the reader currently believes, misunderstands, or cannot do;
- what they should believe, understand, feel, or try afterward;
- the one question the piece answers;
- the strongest fact, example, or tension that earns their attention;
- tempting material that belongs somewhere else.

Name the actual subject and stakes early. Do not hide the lede behind a mystery
hook, abstract principle, slogan, or narration about the research process. A
clever line may sharpen a clear idea; it may not replace one.

Prefer one developing example over a sequence of disconnected examples. Give
Read the full skill on GitHub

Details

Skill name
swyx-writing
Repository
swyxio/skills
Path
swyx-writing/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Swyx Writing skill do?

Apply swyx's reusable nonfiction writing preferences when drafting or materially revising prose, including technical posts, essays, research memos, reports, documentation, profiles, scripts, announcements, and publishing copy. Use as the shared style and editing layer alongside the skill that owns the subject or format. Do not use for verbatim transcription, code-only work, or fiction unless the user explicitly asks for swyx's nonfiction voice.

How do I install the Swyx Writing skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add swyxio/skills --skill swyx-writing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Swyx Writing popular?

It lives in swyxio/skills, which has 201 GitHub stars and 12 forks.

Related skills

Accelevents API

201

swyxio/skills

Use when reading or updating AI Engineer Europe speaker records through the Accelevents REST API, especially for full-record PUT updates, auth header quirks, and preserving existing speaker fields.

Software Development12

Accelevents Speaker Sync

201

swyxio/skills

Use when website speaker, session, schedule, room, track, or headshot changes must be synchronized back to Accelevents for AI Engineer Europe 2026.

AI, LLMs & Agents12

Agents SDK

201

swyxio/skills

Build or debug stateful applications that specifically use Cloudflare's `agents` package, including Agent classes, routing, callable methods, synchronized state, scheduling, AIChatAgent, durable execution, or Agents SDK client hooks. Do not trigger for generic AI-agent design, the OpenAI Agents SDK, or ordinary Durable Object work that does not use the Cloudflare Agents SDK.

AI, LLMs & Agents12

Tweet Writing

201

swyxio/skills

Draft or revise tweets and quote posts for swyx or Latent Space using real peer examples, source material, and the account's voice.

Writing & Content12

Summarization

191

jwynia/agent-skills

Create effective summaries by matching summarization type to purpose, audience, and context. Use when asked to summarize, create TLDR, condense content, or create executive summaries. Keywords: summary, TLDR, condense, executive summary, abstract.

Writing & Content24

Worldbuilding

191

jwynia/agent-skills

Diagnose world-level story problems. This skill should be used when settings feel thin, institutions feel designed rather than evolved, economies don't make sense, or non-human species feel like humans in costume. Keywords: worldbuilding, setting, world, institutions, economy, culture, species, consequences.

Writing & Content24

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.