CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

simple-english

Rewrite text to ASD-STE100 Simplified Technical English.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./optional-skills/creative/simple-english/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is an unusually dense, example-driven rulebook with concrete limits, substitution tables, and an explicit self-check workflow — near the top of the actionability and workflow-clarity anchors. Its only deductions are minor repetition across sections and a monolithic inline rule catalog that keeps it just short of ideal progressive disclosure.

DimensionReasoningScore

Conciseness

The body is dense, mostly tabular, and carries information Claude does not reliably know (53 rule numbers with exact word limits — the file itself notes agents invent the numbering). It is not 5 because some guidance is repeated: the check/verify/confirm verb ruling appears in 'Your Task', Section 3's modal note, and the consistency-pass table, and modal guidance appears both in Section 3 and as a separate 'modal ladder' table.

4 / 5

Actionability

Guidance is fully concrete: exact word limits (20/25), before/after rewrites for each rule family, a specific slop-to-simple substitution table, a modal ladder, and a self-check with literal search strings ('ll', 'has been', ';'). Per the code_vs_instruction note, absence of code is not penalized — this is actionable at the level of copy-paste patterns.

5 / 5

Workflow Clarity

'Your Task' gives a clear 6-step sequence (select mode, classify, fix vocabulary, apply rules, self-check, deliver) with an explicit validation stage ('This step is not optional') and a fix-then-deliver feedback loop, plus a separate check-mode workflow with a defined output format. File rewrites even distinguish patch vs write_file and guard untouchables.

5 / 5

Progressive Disclosure

Two one-level-deep references (references/checklist.md, references/use-cases.md) exist on disk, are referenced inline where relevant, and are indexed in a closing References section — well signaled. It is not 5 because the 150-line rule catalog is fully inlined in SKILL.md rather than split out, so the file is a complete rulebook rather than a lean overview with well-signaled deep-dives.

4 / 5

Total

18

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is short, precise, and third-person, with a clear niche in a named standard. Its main weakness is the complete absence of a 'when to use' trigger clause and of natural trigger variations, which leaves both completeness and trigger-term quality at the midpoint.

Suggestions

Append a 'Use when...' clause naming concrete triggers, e.g. 'Use when the user asks for Simplified Technical English, plain-English technical docs, STE compliance checks, or rewriting READMEs, runbooks, or error messages to a controlled language.'

Add natural trigger synonyms and targets users actually say ('plain English', 'simplify this documentation', 'check STE compliance') so the skill fires for users who do not know the term ASD-STE100.

Mention the check/audit mode ('...or audits text for STE compliance') to distinguish it from pure rewriting skills and reduce overlap with generic humanizer-style skills.

DimensionReasoningScore

Specificity

The description names the exact target standard ('ASD-STE100 Simplified Technical English') and one concrete action ('Rewrite text to'), matching the anchor for domain plus 1-2 concrete actions without comprehensive coverage. It stays at 3 rather than 4 because capabilities the skill actually has (check/audit mode, documentation targets) are not mentioned.

3 / 5

Completeness

'What' is explicit ('Rewrite text to ASD-STE100 Simplified Technical English') but 'when' is entirely absent — no 'Use when...' clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because the rubric requires both what and when present.

3 / 5

Trigger Term Quality

It includes the terms a user who knows the standard would say ('rewrite', 'Simplified Technical English', 'ASD-STE100'), but misses common natural variations such as 'plain English', 'simplify', or text-type triggers like 'docs' and 'runbooks'. This lands on 'some relevant keywords but missing common variations', not 4, since synonym coverage is thin.

3 / 5

Distinctiveness Conflict Risk

The named standard carves a mostly distinct niche with low conflict risk, matching 'mostly distinct; minor overlap risk with closely related skills' — generic text-rewriting skills (e.g., a humanizer-style skill) could fire on the same 'rewrite this text' phrasing. It is not 5 because no trigger terms distinguish it from those neighbors.

4 / 5

Total

13

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

NousResearch/hermes-agent

Path

optional-skills/creative/simple-english/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.