✍️
WritingTypeScript

Plain Language in Code

by GaZmagik

Plain Language in Code is a Writing skill for Claude Code, published by GaZmagik in iso-24495.

171 stars8 forkson GaZmagik/iso-24495Added 2026/09/07+4% in starsRepository updated 2026/09/06
agent-skillsclaude-codeclaude-code-pluginclaude-code-skillscodexcodex-plugincodex-skillsiso-24495llm-toolsplain-languagereadabilitytechnical-writing
Install in seconds
Install Plain Language in Code
Copy Plain Language in Code into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/GaZmagik/iso-24495/tree/main/skills/iso-24495-code ~/.claude/skills/iso-24495-code

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/GaZmagik/iso-24495.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
skills/iso-24495-code/SKILL.md in GaZmagik/iso-24495
Installs to
~/.claude/skills/iso-24495-code
Collection
One of 8 skills cataloged from this repository
Category
Writing1328 skills

What Plain Language in Code does

Plain Language in Code applies ISO 24495-1 principles to source code a person reads. Use it when writing or restructuring code to improve ordering, names, comments, and error messages without changing behavior.

Plain Language in Code is cataloged under Writing on DirSkills. Plain Language in Code comes from a repository tagged agent-skills, claude-code, claude-code-plugin, claude-code-skills and codex.

Documentation

README

Plain language in code

Extends ISO 24495-1 to source code. Code is read far more often than it is written, so the person reading it is the reader the standard is about.

Scope. This skill governs what a reader reads: the order units appear in, what they are called, what the comments say, and what an error tells the person who hits it.

It does not govern correctness, performance, or system design. It does govern local organisation, in rules 1 and 2, because where a unit sits and how far it reaches decide what a reader must hold in their head. For maintainability weaknesses such as complexity and dead code, use a code quality skill built on ISO/IEC 5055.

This is an interpretation of ISO 24495-1 applied by analogy, not a conformance claim.

The four principles, in code

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Plain Language in Code

  • What else does GaZmagik publish alongside Plain Language in Code?

    Plain Language in Code is one of 8 skills that DirSkills catalogs from GaZmagik/iso-24495, the repository it ships in. Its siblings there include ISO 24495 3 Plain Language, ISO 24495 Plain Language and ISO 24495 Style. Each one is a separate skill with its own page in this directory, installs the same way Plain Language in Code does, and is maintained by GaZmagik in that same repository. The rest of the collection is listed on the GaZmagik/iso-24495 page.

  • How does Plain Language in Code compare to other Writing skills?

    Plain Language in Code ranks #1172 by stars among the 1328 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Plain Language in Code against them. Open each page to compare what they document and how they install.

More from GaZmagik/iso-24495

Plain Language in Code is one of 8 skills cataloged on DirSkills from GaZmagik/iso-24495.

See all 8 skills
📝
2h ago

ISO 24495 3 Plain Language

ISO 24495 3 Plain Language applies plain-language rules to technical writing, software documentation, and architecture analysis. Use it when you need clearer explanations, cited code references, and structured technical output.
Writing
1718
📄
2h ago

ISO 24495 Plain Language

ISO 24495 Plain Language guides document design for complex documents so readers can find, navigate, and understand content through headings, layout, and navigation aids. Use it when restructuring reports, specs, guides, or other long-form documents.
Writing
1718
📝
2h ago

ISO 24495 Style

ISO 24495 Style applies plain-language response rules to every reply and points to the relevant sector skills. Use it when you want outputs that are relevant, findable, understandable, and usable.
Writing
1718
📝
2h ago

ISO 24495 Text Audit

ISO 24495 Text Audit checks selected Markdown or text files for deterministic plain-language findings. Use it when you want mechanical readability and scope issues reported without rewriting the text.
Writing
1718
📝
2h ago

ISO 24495-1 Plain Language

ISO 24495-1 Plain Language sets rules for clear, structured user-facing output. Use it when you want responses that are relevant, findable, understandable, and usable.
Writing
1718
⚖️
2h ago

ISO 24495-2 Plain Language

ISO 24495-2 Plain Language guides legal and compliance writing for contracts, licenses, and regulatory text. Use it when drafting or revising user-facing legal language while preserving enforceability.
Writing
1718