🧭 Decision Guide
Why trending now: Cannot be determined from the supplied material.
Try it if you
-
You need to rewrite a tool description, error message, or inter-agent instruction into English that machines can parse more easily.The README's “Scope” lists agent-to-agent messages, tool/function descriptions, error messages, and inter-agent instructions.
-
You want to use Strict mode for procedures, error messages, and tool descriptions.The README's “What This Skill Does” says Strict covers procedures, error messages, and tool descriptions.
-
You need checks for semicolons, passive voice, long sentences, or selected phrasal verbs.The README says the deterministic linter checks semicolons, passive voice, long sentences, and a short list of phrasal verbs.
Skip it if you
-
You need formally compliant ASD-STE100 documentation.The README explicitly says the project does not reproduce the official approximately 900-word dictionary and recommends the real standard for certified documentation.
-
Your content is creative writing or marketing copy where voice and nuance are important.The README's “Scope” explicitly lists creative writing and marketing copy as not built for.
-
You need the linter to prove that a rewrite preserved requirement strength or original meaning.The README explicitly says the linter does not compare the original with the rewrite, verify requirement strength, or prove meaning preservation.
Requirements
- Claude Code is required because the README defines the project as a Claude Code skill.
- The skills CLI can be used for installation; the README gives npx skills add danyuchn/asd-ste100-skill.
- The repository's linter is run with the Python script scripts/ste-lint.py.
- The README does not specify version requirements for Claude Code, Python, or the skills CLI.
First step (verbatim from README)
npx skills add danyuchn/asd-ste100-skill
Watch out
-
The repository's SKILL.md is not a clean lint sample because its rule tables quote the forbidden patterns.The README explicitly says the repository's prose does not lint clean and gives python scripts/ste-lint.py --baseline 41 SKILL.md.
-
examples/linter-edge-cases.md is a test fixture and should not be treated as compliant STE prose.The README explicitly says the file contains intentionally invalid Markdown list items.
-
The linter recognizes only a limited list of phrasal verbs, so take off the panel passes.The README lists the supported phrasal verbs and explicitly states that take off the panel passes.
-
The npx skills installation sends anonymous telemetry; DISABLE_TELEMETRY=1 opts out.The README's “Quick Install” section describes the telemetry fields and gives DISABLE_TELEMETRY=1.
Alternatives
-
Official ASD-STE100 standard:It is better when you need certified STE-compliant documentation or the official approximately 900-word approved dictionary.README, “What This Skill Does”
Not stated in the README
- The README does not specify a minimum or supported Claude Code version.
- The README does not provide rewrite latency, throughput, or maximum text-length limits.
- The README does not provide automated test counts, coverage, or CI status.
- The README does not state which third-party dependencies the Python scripts require.
- The README does not describe direct integration methods for agent frameworks other than Claude Code.
- The project has 9 contributors and 10 recent commits, but the README does not describe maintainer ownership or a release plan.
💡 Deep Analysis
6
No
I manage aerospace documentation that requires formal ASD-STE100 compliance evidence. Can this Claude Code skill replace the official standard and compliance review?
No. It cannot replace the official ASD-STE100 standard or a formal compliance review. It is a lightweight rewriting skill for agent-facing output, not an ASD-STE100 certification tool.
- The README explicitly says that the project does not reproduce ASD’s approximately 900-word approved dictionary. It applies the underlying principle of using the plainest available word consistently instead.
- Rules that depend on the ASD dictionary are handled as advisory, so the skill does not perform complete vocabulary compliance validation.
- The linter checks only a limited set of structural patterns. It does not verify semantic equivalence between the original and rewrite or prove that requirement strength stayed unchanged.
- The stated scope focuses on agent-to-agent messages, tool descriptions, error messages, and system prompts. It does not define a formal evidence or certification workflow for aerospace, medical, or industrial-safety documentation.
- What This Skill Does: “It does not reproduce ASD's official ~900-word approved dictionary”
- What This Skill Does: “The rules that depend on ASD's dictionary are flagged as advisory rather than enforced”
- What This Skill Does: “It does not compare an original text with a rewrite ... or prove that the rewrite preserved meaning”
- Scope: “Built for agent-to-agent messages, tool/function descriptions, error messages, system prompts”
npx skills add danyuchn/asd-ste100-skill
No
I use Python and Markdown and want pre-commit checks for semicolons, passive voice, long sentences, and a limited phrasal-verb list. Can this linter serve as a complete STE compliance gate?
No. It is suitable for limited structural checks, but not as a complete ASD-STE compliance gate, an official dictionary validator, or a semantic-preservation checker.
- The README lists deterministic checks for semicolons, a short set of soft phrasal verbs, nominalizations, marketing adjectives, passive voice, present-perfect forms, long sentences, synonym rotation, and dangling conjunctions in supported list items.
- It explicitly does not check noun-cluster length, does not know phrasal verbs outside its configured list, and never flags hedges or modality.
- The project does not reproduce ASD’s official approximately 900-word approved dictionary. It therefore cannot replace the real standard or a formal compliance review.
- A zero-violation result only means that the configured structural checks found no issue. It does not show that the text is unambiguous or that a rewrite preserved meaning.
- What This Skill Does: “The deterministic linter checks semicolons ... passive voice ... long sentences”
- What This Skill Does: “It does not check noun-cluster length ... and it does not know phrasal verbs outside its list”
- What This Skill Does: “It does not reproduce ASD's official ~900-word approved dictionary”
- What This Skill Does: “A zero-violation result means that the configured structural checks found no problems”
python scripts/ste-lint.py --baseline 41 SKILL.md
Yes
I write English tool descriptions and error messages in Claude Code, and downstream agents have no human back-channel. Should I use this skill in Strict mode to rewrite them?
Yes. Strict mode is specifically intended for tool descriptions, error messages, and procedures, and it prioritizes one action per sentence, explicit actors, and clear conditions.
- The “What This Skill Does” section states: “Strict covers procedures, error messages, and tool descriptions.”
- The skill checks ambiguous wording, passive voice, multiple instructions, long sentences, nominalizations, and complex tenses sentence by sentence. It keeps longer wording when shortening could remove facts, conditions, or scope qualifiers.
- Its default output is only the rewritten text. You can request “show the diff” or “explain the changes” when rule-level review is needed.
- It does not prove that requirement strength or meaning was preserved. You must still check words such as “must,” “may,” and “should,” as well as negation and exceptions, and it does not replace tool-contract validation.
- What This Skill Does: “Strict covers procedures, error messages, and tool descriptions”
- What This Skill Does: “without dropping any fact, condition, or scope qualifier”
- What This Skill Does: “The linter checks structural patterns only”
npx skills add danyuchn/asd-ste100-skill
Yes
I mainly write English READMEs and PR descriptions rather than tool descriptions. I want less ambiguity while retaining explanatory prose. Should I use Strict or STE-flavored mode?
Yes. Start with STE-flavored mode. It keeps sentence discipline without imposing the fixed-vocabulary lockdown of Strict mode, making it a better fit for READMEs, PR descriptions, and explanatory prose.
- The mode definition in the README explicitly assigns STE-flavored to “READMEs, PR descriptions, and explanatory prose.”
- It retains sentence discipline but does not enforce a fixed vocabulary, so necessary technical terminology has more room to remain unchanged.
- The project is intended for English that machines or non-native readers must parse directly, but it is not built for creative writing, marketing copy, or content whose value depends on voice, nuance, or metaphor.
- The default output is only the rewritten text. Add “show the diff” when you need to inspect which rules were applied.
- What This Skill Does: “STE-flavored covers READMEs, PR descriptions, and explanatory prose”
- What This Skill Does: “STE-flavored keeps the sentence discipline but not the fixed-vocabulary lockdown”
- Scope: “Not built for creative writing, marketing copy, or anything where voice and nuance are the point”
- Usage: “To see which rules were applied, add ‘show the diff’”
npx skills add danyuchn/asd-ste100-skill
It depends
I pass inter-agent instructions through a multi-agent tool-call chain. If conditions, scope, and requirement strength must remain intact, will this skill delete important information to make the text shorter?
It depends. The design explicitly aims to preserve conditions and scope, but the project does not guarantee semantic equivalence or unchanged requirement strength.
- The README says the rewrite does not drop any “fact, condition, or scope qualifier.” If shortening would lose required precision, it keeps the longer wording and flags the trade-off.
- However, the linter checks structural patterns only. It does not compare the original with the rewrite or prove that meaning was preserved.
- The stated scope includes agent-to-agent messages, inter-agent instructions, system prompts, tool/function descriptions, and error messages, so your text type is directly targeted.
- Generated rewriting can still misunderstand domain terms, negation, exceptions, or modal verbs. A zero-violation linter result is therefore not evidence that a tool call is semantically safe.
- What This Skill Does: “without dropping any fact, condition, or scope qualifier from the original”
- What This Skill Does: “It does not compare an original text with a rewrite, verify that requirement strength stayed the same, or prove that the rewrite preserved meaning”
- Scope: “agent-to-agent messages, tool/function descriptions, error messages, system prompts, inter-agent instructions”
npx skills add danyuchn/asd-ste100-skill
Yes
I use project-scoped Claude Code installation and Python Markdown checks. Is this project lightweight enough to add to an existing repository without a server or database?
Yes. It is lightweight enough for project-scoped adoption because installation uses npx skills or Git, while the runtime consists of a Claude Code skill, rule references, examples, and an independent Python script rather than a server or database.
- The Quick Install section provides
npx skills add danyuchn/asd-ste100-skillfrom the project root and says that it installs the skill for the current project. - The Python linter runs directly from the command line, for example with
python scripts/ste-lint.py --baseline 41 SKILL.md. - Project data identifies Python as the main language and MIT License as the license. The README also provides
npx skills updatefor later updates. - However, the README does not provide a ready-made CI integration, editor plugin, or service API. Direct adoption therefore means installation and command-line checking; repository-specific automation must be built separately.
- Installation / Quick Install: “Run it from your project root”
- Installation / Quick Install: “npx skills add danyuchn/asd-ste100-skill”
- What This Skill Does: “The linter checks structural patterns only”
- Project data: main_language is Python; license is MIT License
npx skills add danyuchn/asd-ste100-skill
✨ Highlights
-
Uses ASD-STE100 rules to rewrite tool descriptions, error messages, and agent instructions.
-
Strict and STE-flavored modes cover different types of English text.
-
Deterministic checks cover semicolons, passive voice, long sentences, and other structural patterns.
-
The GitHub repository has 4,484 stars but currently has no releases.
🔧 Engineering
-
Reads English meaning, flags rule violations sentence by sentence, and rewrites while preserving facts and conditions.
-
Run python scripts/ste-lint.py to check structural STE patterns.
-
Use show the diff to output a before-and-after table for each rule.
⚠️ Risks
-
It does not include ASD's official approximately 900-word dictionary and cannot prove formal STE compliance.
-
The linter does not verify meaning, requirement strength, or fact preservation between the original and rewrite.
-
The linter does not check noun-cluster length, phrasal verbs outside its list, hedges, or modality.
👥 For who?
-
Claude Code users who handle agent-to-agent messages, tool descriptions, or system prompts.
-
Engineering teams maintaining English error messages and inter-agent instructions.
-
Authors needing creative writing, marketing copy, or nuanced voice should not use it.