jgsystemsconsulting

Plain Language — Development skill for Claude Code

Development community

Agent skill: write in plain language (Federal Plain Language Guidelines + ISO 24495-1), with a mechanical checker.

How to install Plain Language

This entry records only its repository, not the path inside it, so there is no exact command to give. Open jgsystemsconsulting/plain-language and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Plain Language does

Agent skill: write in plain language (Federal Plain Language Guidelines + ISO 24495-1), with a mechanical checker. Sibling of simplified-technical-english.

Alternatives in Development

Contributing To Auto-claude-code-research-in-sleep (aris) — English 中文版 Thank you for your interest in contributing to ARIS 3.1k ★
Asd Ste100 Skill — ASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent 1.5k ★
Ste Zh — Agent skill: 按 ASD-STE100 (Simplified Technical English) 原则用中文向用户汇报结果 318 ★

README

plain-language

A skill that writes and rewrites text in plain language. It follows the same layout as our Simplified Technical English skill: rules in SKILL.md, reference files, worked examples, and a mechanical checker. The basis is the US Federal Plain Language Guidelines and ISO 24495-1:2023. This project cites and paraphrases that standard. It does not reproduce it.

Status: shipped. Version 1.0, dated 2026-10-13; [RELEASE-NOTES.md](RELEASE-NOTES.md) records the acceptance results and how the checker was verified. [PLAN.md](PLAN.md) keeps the original work plan. To apply the skill, start with [SKILL.md](SKILL.md), which holds the distilled rules and the write-check-fix procedure.

Layout

Path	Contents
SKILL.md	Distilled rules and the write-check-fix procedure
references/rules.md	Full rule set with before-and-after examples
references/word-list.md	Simple-first word guidance and a jargon watch list
references/reading-level.md	Readability formulas, report-only grade, honest limits
scripts/plain_check.py	Mechanical checker, non-zero exit on errors
examples/before-after.md	Worked examples across policy, technical, and legal-adjacent text

Related project

[simplified-technical-english](https://github.com/jgsystemsconsulting/simplified-technical-english) is the sibling skill for ASD-STE100. It proves the architecture: a style skill holds up only when a checker closes the loop.