language-expression
Skill0 starsChanged 3 days agoMITView on GitHub
Language expression and information communication standard. Requires natural, complete, and accurate expression, and forbids self-invented compressed terms, vague terminology, and mechanical phrasing.
In this repository17 other files it gives its agents.
- .cursor/rules/engineering-context.mdcCursor rule
- change-report-deliverySkill
- code-asset-inventorySkill
- data-audit-reproducibilitySkill
- data-first-executionSkill
- documentation-structureSkill
- engineering-context-completenessSkill
- engineering-transparencySkill
- explicit-instruction-fidelitySkill
- interface-contractSkill
- production-loggingSkill
- repository-publication-hygieneSkill
- task-execution-governanceSkill
- technical-documentationSkill
- testing-verificationSkill
- unfinished-work-trackingSkill
- user-intent-prioritySkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 10 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 11
All user-facing output must prioritize:
- Distinctive: line 19
Do not sacrifice understanding in order to save words, project a sense of professionalism, or keep tables visually tidy.
- Distinctive: line 82
Not everything is required to be written as a long explanation.
- Distinctive: line 84
Only enough words to fully convey the meaning are needed.
- Distinctive: line 111
All user-facing content must use natural, accurate, and formal language.
- Distinctive: line 135
Prefer the established and general terminology of software engineering and computing.
- Distinctive: line 136
Prefer the names already used in the project code, the data structures, and the existing technical specifications.
- Distinctive: line 139
When a term is not necessary, use clear and accurate natural language directly.
- Distinctive: line 151
All code variable names, function names, JSON fields, database fields, configuration keys, file names, and data structure fields must use …
- Very specific: line 157
When expressing a quantity, prefer a complete expression such as count, total, or number.
- Distinctive: line 158
When a name expresses a time, a status, a type, a quantity, an index, or similar information, it must state the actual meaning of the field …
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Language Expression and Information Communication Standard
I. Core Principle
All user-facing output must prioritize:
- Clear semantics.
- Natural expression.
- Complete information.
- Accurate terminology.
- Continuous context.
Do not sacrifice understanding in order to save words, project a sense of professionalism, or keep tables visually tidy.
II. Unnatural Compressed Expression Is Forbidden
Forbidden:
- Inventing compressed terms that lack a clear meaning.
- Arbitrarily splicing multiple words into a new concept.
- Reducing a complete action to a hard-to-understand label.
- Using internal shorthand that only the current Agent can understand.
- Removing necessary semantics for the sake of table tidiness.
- Using abstract words in place of actual actions.
For example:
Not recommended:
- 数据拉平 (flatten the data)
- 需求摸排 (survey the requirements)
- 结果承接 (receive and carry over the results)
- 逻辑收口 (close out the logic)
- 能力下沉 (push capabilities down)
Recommended:
- 将不同来源的数据转换为统一结构 (convert data from different sources into a unified structure)
- 收集并分析实际需求 (collect and analyze actual requirements)
- 将分析结果传递给后续模块 (pass the analysis results to subsequent modules)
- 明确并完成当前逻辑的最终处理 (clarify and complete the final handling of the current logic)
- 将重复使用的功能提取到公共模块 (extract repeatedly used functionality into a shared module)
III. Use of Professional Terminology
Industry-standard terminology is permitted.
However, important terminology on first appearance should be explained as needed.
Forbidden:
- Self-invented professional terminology.
- Arbitrarily changing the name of the same concept.
- Using English abbreviations to conceal meaning.
- Packaging ordinary business actions into complex technical concepts.
English terminology may be retained, but readers must be able to understand it.
Section VIII states the scope rule that governs every form of output covered by this standard.
IV. Headings and Field Naming
Headings should directly express their topic.
Step names should state the specific work performed.
Table field names should carry clear semantics.
Function and variable names should reflect actual responsibilities.
Names with unclear meanings must not be used.
V. The Principle of Brevity
Brevity is achieved by removing duplicated information.
It must not be achieved by removing necessary semantics.
Not everything is required to be written as a long explanation.
Only enough words to fully convey the meaning are needed.
VI. Separating Facts from Opinions
Analysis and reports must distinguish:
- Confirmed facts.
- Conclusions supported by data.
- Reasonable inferences.
- Subjective recommendations.
- Information that is not yet confirmed.
Speculation must not be written as fact.
VII. Language Quality Check
Before delivering, check:
- Are there any self-invented compressed terms?
- Are there any expressions with vague meanings?
- Are there unnecessary English abbreviations?
- Are there technical terms missing context?
- Was brevity achieved at the cost of semantics?
- Can someone who did not participate in the task understand it directly?
VIII. Colloquial Expression and Non-Standard Terminology Are Forbidden
All user-facing content must use natural, accurate, and formal language.
This covers every form of output, not only technical documentation:
- Conversational replies.
- Technical documentation.
- Code comments.
- Names of functions, variables, modules, files, and branches.
- Log messages.
- Error messages.
- Delivery reports.
- Explanatory text of any kind.
8.1 Strictly Forbidden
- Substituting conversational, colloquial, or casual phrasing for a formal statement.
- Using internet slang, internal jargon, or non-standard industry expressions.
- Inventing abstract concepts, compressed terms, or spliced words in pursuit of conciseness or an appearance of professionalism.
- Using terms whose meaning is vague and which lack a clear technical definition.
- Packaging ordinary technical concepts into unnecessary abstract expressions.
- Sacrificing the accuracy and completeness of the language for the sake of visual regularity or stylistic consistency.
8.2 Terminology Rules
- Prefer the established and general terminology of software engineering and computing.
- Prefer the names already used in the project code, the data structures, and the existing technical specifications.
- Distinct technical concepts must be distinguished accurately and must not be conflated.
- Professional terminology serves accurate expression; it is not a device for manufacturing an appearance of professionalism.
- When a term is not necessary, use clear and accurate natural language directly.
8.3 Scope
This standard applies to all languages, all forms of output, and all project modules. It is not limited to technical documentation.
Final requirement: language must be natural, formal, accurate, and specific. Colloquial expression is forbidden, invented jargon is forbidden, and the misuse of abstract terminology is forbidden.
IX. Arbitrary Abbreviation and Compressed Code Naming Are Forbidden
All code variable names, function names, JSON fields, database fields, configuration keys, file names, and data structure fields must use names whose meaning is explicit and easy to understand.
9.1 Rules
- Abbreviating a word in order to reduce the number of characters is forbidden.
- Single-letter prefixes and opaque abbreviations such as
n_,cnt_,tmp_, andcfg_are forbidden, unless they belong to an existing project convention or carry a well-established industry-standard meaning. - When expressing a quantity, prefer a complete expression such as
count,total, ornumber. Usepage_count, notn_pages. - When a name expresses a time, a status, a type, a quantity, an index, or similar information, it must state the actual meaning of the field explicitly.
- Fields whose meanings differ must not be forced into similar names in the name of consistency.
- A newly created data structure must be understandable from its field names alone by a developer who did not take part in the implementation.
- The naming conventions already used by the current project take precedence. If an existing name is unclear, the unclear name must not be copied into new code.
- An existing field name must not be changed on the agent's own initiative. Where historical data, interface compatibility, or a database migration is involved, the impact must be analyzed and a proposal put forward first.
9.2 Scope
This section covers every identifier that carries meaning in a project:
- Variable names.
- Function and method names.
- Class and type names.
- JSON, YAML, and configuration keys.
- Database column names.
- File and directory names.
- Data structure fields.
- API parameter names.
- Branch and tag names.
It applies to newly created names and to names introduced by a migration, a refactor, or an interface change.
9.3 Relationship to Interface Contracts
The rules in section IX govern how a name is chosen. The rules about renaming an existing field, and about field consistency across modules, are specified in interface-contract. A name that satisfies section IX may still be forbidden to change, because the interface contract governs compatibility.
Rule 8 above states the prohibition itself. interface-contract section 8.1 states the analysis that must be produced before a rename is proposed.
9.4 Judgement Standard
Naming must prioritize semantic clarity over a smaller character count, faster typing, or a convention that merely looks like programmer habit.
A name passes this standard when a reader can state what it holds, what it counts, or what it represents without opening the file that declares it.
Final requirement: an identifier is written for the developer who reads it later, not for the author who is typing it now.
X. Final Principle
It is acceptable to be concise, but not vague.
It is acceptable to be professional, but not obscure.
It is acceptable to be structured, but not at the cost of the completeness of natural language.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

