Skip to content

Releases

v1.1.0: clear, readable, unambiguous text in any language

v1.1.0: clear, readable, unambiguous text in any language Latest
Latest

Choose a tag to compare

View all tags
@amaklakov-droid amaklakov-droid released this 02 Oct 19:32
v1.1.0
462217f

Controlled Language is now positioned for any text that must be understood correctly the first time: documentation, instructions, explanations, emails, reports, and answers, in any language. Technical documentation is one use case of many.

Changed

  • New skill description, so the agent also starts the skill for clear emails, reports, explanations, and answers.
  • New README intro, levels table, and examples (English and Russian).
  • Plugin manifests, llms.txt, AGENTS.md, and the system prompt follow the new positioning.

Added

  • A README banner and a 1280×640 social preview image in .github/assets/.

The rules and the checker script did not change.

Update

  • Claude Code plugin: /plugin marketplace update controlled-language-skill, then update the plugin in /plugin.
  • skills installer: npx skills update controlled-language.
  • Claude.ai and Claude Desktop: upload the new controlled-language.zip below.
Assets 3
Loading

v1.0.0: Controlled Language

v1.0.0: Controlled Language

Choose a tag to compare

View all tags
@amaklakov-droid amaklakov-droid released this 02 Oct 16:53
v1.0.0
d268ec3

First public release of Controlled Language, an open-source Agent Skill for clear technical documentation in any language.

The skill makes an AI agent write, rewrite, and review documentation in a controlled language. The rules come from the principles of ASD-STE100 Simplified Technical English.

What is in this release

  • Four modes: write, rewrite, review (a report with rule IDs), and respond.
  • Three levels in all languages: 1 Light (about 50% of the rules), 2 Standard (about 80%, the default), 3 Strict (100%).
  • English is the native language of the approach: 39 rules, and the approved vocabulary at Level 3.
  • Other languages: 32 universal rules and language files. Russian, German, French, and Spanish are drafts that wait for a native-speaker review.
  • Project terms: a glossary of technical nouns and verbs in .controlled-language.yml, front matter, and inline markers.
  • Checker script: Python 3.8+, no dependencies, language detection, use in CI.
  • Documentation in English and Russian, and a process for new languages.

Install

npx skills add amaklakov-droid/controlled-language-skill

Claude Code: /plugin marketplace add amaklakov-droid/controlled-language-skill, then /plugin install controlled-language@controlled-language-skill.

Claude.ai and Claude Desktop: download controlled-language.zip below. Then upload it in Settings → Capabilities → Skills.

Credits and legal notice

The idea came from a post by Andrej Karpathy.

This project is not affiliated with or endorsed by ASD. ASD-STE100 is a trademark of ASD. The project does not contain the ASD-STE100 standard or its dictionary. Licensed under Apache-2.0.

Loading