natural-writing

Name: natural-writing
Author: flutter

2.7kstars159forks

How to install natural-writing?

flutter/agent-plugins/natural-writing

$npx -y skills add flutter/agent-plugins --skill natural-writing

Installs into the current project.

Summary

Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation.

Files · 1

View on GitHub

SKILL.md

1	# Rules for Natural Writing
2
3	This document outlines strict rules to avoid common "AI-isms"—stylistic and structural patterns that language models typically fall into. Follow these rules to produce content that is more understandable, and reads as natural, human-authored text.
4
5	## 1. Vocabulary & Phrasing Controls
6
7	### The "Banned" List
8
9	Avoid these words, which are statistically overrepresented in AI text. Use simpler, more direct alternatives.
10
11	* Verbs: delve, underscore, highlight (as verb), foster, cultivate, maximize, leverage, democratize, ensure, align with, resonate with, encompass, bridge.
12	* Nouns: tapestry, landscape (abstract), realm, testament, interplay, synergy, cornerstone, hub, ecosystem (abstract).
13	* Adjectives: pivotal, crucial, vibrant, intricate, nuanced, unwavering, indelible, uncharted, rapidly evolving, transformative, breathtaking, nestled, dynamic.
14
15	### Avoid "Copula" Substitutions
16
17	Do not replace simple "is/are" verbs with flowery equivalents.
18
19	* Bad: "The library serves as a center for learning."
20	* Bad: "The statue stands as a monument to..."
21	* Good: "The library is a center for learning."
22	* Good: "The statue is a monument to..."
23
24	### Eliminate "Elegant Variation"
25
26	Do not use synonyms just to avoid repeating a subject's name (e.g., "the eponymous character," "the titular protagonist," "the celebrated author"). It is acceptable to repeat the name or use pronouns naturally.
27
28	### Banned Temporal Words in Code & Comments
29
30	Do not use relative temporal terms in code, variable names, function names, or comments. These words lose their meaning as the codebase evolves over time.
31	* Banned Words: now, currently, existing behavior, previous behavior, old, new, modern.
32	* Bad: `// This function now uses the config parser instead of hardcoding.`
33	* Good: `// Resolves paths via [ConfigParser.loadConfig] to support custom config locations.`
34
35	## 2. Content & Tone
36
37	### No "Puffery" or Forced Significance
38
39	Do not inflate the importance of a topic with vague praise. If a subject is important, the facts should demonstrate it without help.
40
41	* Rule: Avoid phrases like "serves as a testament to," "marking a pivotal moment," "underscoring the importance of," "leaving an indelible mark," or "shaping the landscape."
42	* Bad: "The founding of the institute marked a pivotal moment in the evolution of regional statistics, representing a significant shift toward independence."
43	* Good: "The institute was founded in 1989 to collect regional statistics."
44
45	### No Superficial Analysis
46
47	Avoid attaching "dangling" present-participle phrases that offer vague commentary.
48
49	* Rule: Delete clauses starting with "highlighting," "emphasizing," "reflecting," "showcasing," or "demonstrating" if they just restate the obvious or add fluff.
50	* Bad: "The building uses blue glass, reflecting the region's natural beauty and symbolizing unity."
51	* Good: "The building uses blue glass."
52
53	### Avoid Promotional Language
54
55	Maintain a neutral tone. Avoid "advertisement" words.
56
57	* Words to Watch: boasts, features (as a verb), offers, premier, leading, state-of-the-art, committed to, dedicated to.
58	* Bad: "Nestled in the heart of the city, the hotel boasts a vibrant atmosphere."
59	* Good: "The hotel is located in the city center."
60
61	### No "Challenges and Future Outlook" Formula
62
63	LLMs often end articles with a generic "Despite challenges... remains important" conclusion.
64
65	* Rule: Do not end with a summary paragraph starting with "Despite \[X\], \[Subject\] continues to..." or speculating on the future. End with the last fact.
66	* Bad: "Despite facing economic hurdles, the company continues to thrive and remains a beacon of innovation."
67
68	### No "Title as Proper Noun" Leads
69
70	Do not treat a descriptive article title (like a list or broad topic) as a proper noun in the first sentence.
71
72	* Bad: "The List of songs about Mexico is a curated compilation..."
73	* Good: "This list contains songs about Mexico..."
74
75	### No Generic "See Also" Links
76
77	Do not populate "See Also" sections with broad, generic terms.
78
79	* Rule: Links must be directly relevant and specific to the subject.
80	* Bad: Linking Financial technology in an article about a specific startup.
81	* Good: Linking a competitor or specific related technology.
82
83	### Attribution Precision
84
85	Do not use vague "weasel words."
86
87	* Rule: Avoid "Experts argue," "Observers have noted," or "Several sources indicate" unless you cite specific people immediately.
88	* Rule: Do not claim a subject interacts with a "broader" history or trend unless a source explicitly says so.
89
90	## 3. Sentence Structure
91
92	### No Negative Parallelism
93
94	Avoid sentences t

People who liked this also viewed

6 picks

Type

grill-with-docsA relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.SkillsJul 2026537k182k
lark-minutes飞书妙记：搜索妙记、查看妙记基础信息、下载/上传音视频、读取或编辑妙记的产物内容、改标题、替换说话人/关键词、申请妙记查看/编辑权限。当给出minute_token、本地音视频文件，要查/改/转妙记产物，或用户明确要主动申请妙记权限时使用；本地音视频转纪要/逐字稿优先走本 skill，不要用 ffmpeg/whisper 本地转写。不负责：获取会议关联妙记，或仅按自然语言标题定位纪要SkillsJul 2026379k16k
lark-markdown飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。SkillsJul 2026295k16k
docxUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', SkillsJul 2026157k163k
edit-articleSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026154k181k
lark-note飞书会议纪要（Note）直查：已知 note_id 时查询纪要详情、展示类型、关联文档 token，并读取 unified 原始逐字记录。当用户已持有 note_id，或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。SkillsJul 2026154k16k

natural-writing

2.7kstars159forks

View on GitHub

How to install natural-writing?

flutter/agent-plugins/natural-writing

$npx -y skills add flutter/agent-plugins --skill natural-writing

Installs into the current project.

Summary

Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation.

Files · 1

View on GitHub

SKILL.md

1	# Rules for Natural Writing
2
3	This document outlines strict rules to avoid common "AI-isms"—stylistic and structural patterns that language models typically fall into. Follow these rules to produce content that is more understandable, and reads as natural, human-authored text.
4
5	## 1. Vocabulary & Phrasing Controls
6
7	### The "Banned" List
8
9	Avoid these words, which are statistically overrepresented in AI text. Use simpler, more direct alternatives.
10
11	* Verbs: delve, underscore, highlight (as verb), foster, cultivate, maximize, leverage, democratize, ensure, align with, resonate with, encompass, bridge.
12	* Nouns: tapestry, landscape (abstract), realm, testament, interplay, synergy, cornerstone, hub, ecosystem (abstract).
13	* Adjectives: pivotal, crucial, vibrant, intricate, nuanced, unwavering, indelible, uncharted, rapidly evolving, transformative, breathtaking, nestled, dynamic.
14
15	### Avoid "Copula" Substitutions
16
17	Do not replace simple "is/are" verbs with flowery equivalents.
18
19	* Bad: "The library serves as a center for learning."
20	* Bad: "The statue stands as a monument to..."
21	* Good: "The library is a center for learning."
22	* Good: "The statue is a monument to..."
23
24	### Eliminate "Elegant Variation"
25
26	Do not use synonyms just to avoid repeating a subject's name (e.g., "the eponymous character," "the titular protagonist," "the celebrated author"). It is acceptable to repeat the name or use pronouns naturally.
27
28	### Banned Temporal Words in Code & Comments
29
30	Do not use relative temporal terms in code, variable names, function names, or comments. These words lose their meaning as the codebase evolves over time.
31	* Banned Words: now, currently, existing behavior, previous behavior, old, new, modern.
32	* Bad: `// This function now uses the config parser instead of hardcoding.`
33	* Good: `// Resolves paths via [ConfigParser.loadConfig] to support custom config locations.`
34
35	## 2. Content & Tone
36
37	### No "Puffery" or Forced Significance
38
39	Do not inflate the importance of a topic with vague praise. If a subject is important, the facts should demonstrate it without help.
40
41	* Rule: Avoid phrases like "serves as a testament to," "marking a pivotal moment," "underscoring the importance of," "leaving an indelible mark," or "shaping the landscape."
42	* Bad: "The founding of the institute marked a pivotal moment in the evolution of regional statistics, representing a significant shift toward independence."
43	* Good: "The institute was founded in 1989 to collect regional statistics."
44
45	### No Superficial Analysis
46
47	Avoid attaching "dangling" present-participle phrases that offer vague commentary.
48
49	* Rule: Delete clauses starting with "highlighting," "emphasizing," "reflecting," "showcasing," or "demonstrating" if they just restate the obvious or add fluff.
50	* Bad: "The building uses blue glass, reflecting the region's natural beauty and symbolizing unity."
51	* Good: "The building uses blue glass."
52
53	### Avoid Promotional Language
54
55	Maintain a neutral tone. Avoid "advertisement" words.
56
57	* Words to Watch: boasts, features (as a verb), offers, premier, leading, state-of-the-art, committed to, dedicated to.
58	* Bad: "Nestled in the heart of the city, the hotel boasts a vibrant atmosphere."
59	* Good: "The hotel is located in the city center."
60
61	### No "Challenges and Future Outlook" Formula
62
63	LLMs often end articles with a generic "Despite challenges... remains important" conclusion.
64
65	* Rule: Do not end with a summary paragraph starting with "Despite \[X\], \[Subject\] continues to..." or speculating on the future. End with the last fact.
66	* Bad: "Despite facing economic hurdles, the company continues to thrive and remains a beacon of innovation."
67
68	### No "Title as Proper Noun" Leads
69
70	Do not treat a descriptive article title (like a list or broad topic) as a proper noun in the first sentence.
71
72	* Bad: "The List of songs about Mexico is a curated compilation..."
73	* Good: "This list contains songs about Mexico..."
74
75	### No Generic "See Also" Links
76
77	Do not populate "See Also" sections with broad, generic terms.
78
79	* Rule: Links must be directly relevant and specific to the subject.
80	* Bad: Linking Financial technology in an article about a specific startup.
81	* Good: Linking a competitor or specific related technology.
82
83	### Attribution Precision
84
85	Do not use vague "weasel words."
86
87	* Rule: Avoid "Experts argue," "Observers have noted," or "Several sources indicate" unless you cite specific people immediately.
88	* Rule: Do not claim a subject interacts with a "broader" history or trend unless a source explicitly says so.
89
90	## 3. Sentence Structure
91
92	### No Negative Parallelism
93
94	Avoid sentences t

People who liked this also viewed

6 picks

Type