skills.rest
wimpysworld
wimpysworldOFFICIAL
Explore all skills by this author →
WebsiteGitHub

communication-rules

Applies house-style writing rules for concise plain British English to agent-generated prose.

716|31|Updated Mar 13, 2023
Search Tags:#style guide#british english#concise writing#prose editing#plain English#writing rules#simplified technical english
One-click install
npx skills add https://github.com/wimpysworld/nix-config --skill communication-rules
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: communication-rules
Source: https://github.com/wimpysworld/nix-config/tree/main/home-manager/_mixins/agentic/assistants/skills/communication-rules
Command: npx skills add https://github.com/wimpysworld/nix-config --skill communication-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AI agents often produce verbose, hedged, or jargon-heavy prose that readers must wade through. This Skill loads a canonical set of communication rules so every reply, report, comment, and message an agent writes is concise, direct, and readable on first pass.

Core Features & Use Cases

  • Substance rules: Lead with the conclusion, ground the reader, state facts once, and end on the next action.
  • Sentence and word rules: Enforce short sentences, active voice, simple tenses, plain vocabulary, and British English spelling based on ASD-STE100 Simplified Technical English.
  • Format and cut-pass rules: Control paragraph structure, code block usage, and a final editing pass that cuts sentences carrying no actionable change.
  • Use Case: An agent drafting a pull request review or incident report applies these rules so a non-native English speaker or a non-technical manager understands it immediately.

Quick Start

Apply the communication rules to rewrite this status update in concise plain British English.

Frequently Asked Questions about communication-rules

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

FAQPage Schema
How do I make AI agent responses more concise and readable?▼

Load a style rule set that the agent applies before drafting. This Skill enforces leading with the conclusion, short sentences, active voice, and a final cut pass that removes sentences carrying no actionable change.

What is ASD-STE100 Simplified Technical English used for?▼

ASD-STE100 is a controlled language that restricts vocabulary and grammar so technical text is unambiguous. This Skill uses it so non-native English speakers and non-technical readers understand agent output on first read.

Does this Skill change code, commands, or file paths in responses?▼

No. The rules require code, commands, file paths, identifiers, error messages, and numbers to stay exact. Only the surrounding prose is rewritten; quoted technical text is never altered.

When should the communication rules not be applied?▼

The rules govern prose an agent produces, not literal content such as code blocks or quoted output. Accuracy always beats style, so facts, conditions, numbers, and scope qualifiers are never dropped to shorten a sentence.

Can I use these writing rules for reports and reviews, not just chat replies?▼

Yes. The rules cover replies, files, comments, messages, and reports. For long-lived documents, the cut pass moves supporting detail below the answer instead of deleting it, so later readers keep the evidence.

Related Skills

Explore More Content & Communication Skills→
466852675466852675

chinese-documentation

Standardize Chinese technical documentation with spacing, punctuation, and terminology rules.

Community
Basic
kortix-aikortix-ai
20.2k

postmortem-draft

Drafts incident postmortem PRs by correlating channel timelines with GitHub deploys and Datadog spikes.

Official
Advanced
3D-Stories3D-Stories
2

rawgentic:update-docs

Orchestrate a 10-step documentation update workflow with accuracy verification against code.

Official
Advanced
cursorcursor
6.6k

technical-writing

Applies Diátaxis, Google style, STE, and Global English rules to technical documentation.

Official
Intermediate