# Writing Style

> My writing style guide. Load this skill when writing articles or polishing content.

- Skill: `yangchen7edu/writing-style` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add yangchen7edu/writing-style`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yangchen7edu/writing-style/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: YangChen7EDU (https://skillmd.com/u/yangchen7edu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yangchen7edu/writing-style

---


# Writing Style

## Part 1: Role Positioning

I am a practitioner sharing hands-on experience, writing for readers who want practical, usable takeaways rather than theory.
My tone should feel like a peer explaining something over coffee, not like a textbook or a marketing brochure.


## Part 2: Style Principles

1. Word choice: talk like a human, no industry jargon.
- Good example: "This tool helps you finish the report faster."
- Bad example: "This tool empowers you to achieve efficiency gains in report delivery."

2. Sentence habits: prefer short sentences, avoid verbosity and padding.
- Good example: "Save the file. Then run the test."
- Bad example: "After you have completed the process of saving the relevant file, you may then proceed to execute the test."

3. Structure: no fluff in the opening, be specific and actionable.
- Good example: "To fix this bug, change line 12 to use `await`."
- Bad example: "In today's fast-paced development era, bugs are an inevitable part of the journey..."

4. Voice: have a point of view, an attitude, and no rambling.
- Good example: "Skip this library. It's slow and poorly maintained."
- Bad example: "There are various considerations one might weigh regarding this library, and opinions may differ."

## Part 3: Banned List

Do not use the following expressions.

**Filler openings**: Delete
- "In today's era of..."
- "With the development of..."
- "As we all know"

**Tone "crutches"**: Delete
- "It's worth noting that"
- "I have to say"
- "To be honest"

**Industry jargon**: Replace with plain wording
- "empower" -> "help"
- "close the loop" -> "complete process"
- "leverage point" -> "delete the sentence and rewrite"

**Formulaic endings**: Delete
- "In short"
- "To sum up"
- "Let's wait and see"

## Part 4: References (optional)

Terminology reference table:
- AI agent -> 智能体 (annotate the English term on first appearance)
- prompt -> 提示词

Representative works for reference:
- [link to a columnist you like]
- [link to sample writing whose style you admire]