CtrlK
BlogDocsLog inGet started
Tessl Logo

simple-english

Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop. Use for documentation, READMEs, runbooks, procedures, error messages, release notes, incident reports, and API guides. Also use when the user says "STE", "Simplified Technical English", "ASD-STE100", "de-slop", "make this readable", "write for non-native readers", or asks for docs that translate well. Enforces the standard's 53 rules: 20/25-word sentence limits, one word one meaning, simple tenses, active voice, condition before command.

73

Quality

92%

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

The canonical home for this skill is simple-english in TanStack/ai

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.

A well-built instruction skill: an explicit task sequence with a mandatory self-check validation loop, rule-by-rule concrete guidance, and real, clearly-labeled reference files. The main gaps are trimming editorial asides from the body and moving the lookup tables (vocabulary rulings, slop substitutions) into a reference file.

Suggestions

Move the 'Known part-of-speech rulings' table and the 'Slop-to-simple substitutions' table (roughly 60 lines of lookup material) into a reference file such as references/vocabulary.md, keeping only the modal ladder and 2-3 representative substitutions inline to cut body tokens.

Trim editorial asides that don't change agent behavior: the 'tested — an agent without this file cited Rule 3.1' anecdote, the trademark/affiliation paragraph, and the full worked Before/After example (or move the example into references/use-cases.md).

The 'Beyond Documentation' section already summarizes references/use-cases.md in six bullets; shorten it to the mode plus a one-line pointer per target type so the reference file carries the detail.

DimensionReasoningScore

Conciseness

The body is dense and mostly earns its tokens: rule tables, Before/After pairs, a modal ladder, and a self-check with literal search patterns ('\'ll\'', 'has been', ';'), none of which re-explains what Claude already knows. It is not a 5 because some material is editorial padding or could be trimmed — the 'tested — an agent without this file cited Rule 3.1' anecdote, the trademark/disclaimer paragraph, and the full worked Before/After example at the end add length beyond the operating minimum. It is clearly above the 'mostly efficient but includes some unnecessary explanation' (3) anchor.

4 / 5

Actionability

Guidance is fully executable throughout: numbered task sequence, a mode-selection table, a classification table with word limits, per-rule numbered instructions, a modal ladder mapping 'should/may/would' to exact rewrites, a slop-to-simple substitution table with concrete replacements, searchable self-check patterns, and Untouchables scoping what never gets edited. As an instruction-only skill with concrete, specific guidance throughout, it matches the top anchor.

5 / 5

Workflow Clarity

'Your Task' gives a clear six-step sequence (select mode → classify → fix vocabulary → apply rules → run self-check → never touch code) with an explicit validation gate ('Run the self-check before you deliver. This step is not optional') and a fix-what-you-find-then-deliver feedback loop. This matches the 'clear sequence with explicit validation steps; feedback loops; checklists' anchor, and the checklist reference provides the recovery detail.

5 / 5

Progressive Disclosure

Both references exist, are one level deep, and are clearly signaled twice with stated purposes ('references/checklist.md — full verification pass... for check mode and final audits'; 'references/use-cases.md — long-form adaptations: error messages, runbooks, incident reports, commits, UI copy, i18n'). However, the main body is ~330 lines and some inline material — the known part-of-speech rulings table and the ~30-row slop substitution table — is lookup material that belongs in a reference file, which keeps it below the 'content appropriately split; easy navigation' (5) anchor while clearly above 'some structure but... content that should be separate is inline' (3).

4 / 5

Total

18

/

20

Passed

Description

96%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.

A strong description: it states what the skill does, when to use it with concrete trigger phrases including colloquial synonyms, and the standard's actual mechanics, all in third person. The only weakness is a couple of broad trigger phrases ('make this readable') that overlap with general writing/editing skills.

DimensionReasoningScore

Specificity

Concrete actions are named precisely ('Write or rewrite technical text with the rules of ASD-STE100', 'Enforces the standard's 53 rules') and enumerate the mechanics ('20/25-word sentence limits, one word one meaning, simple tenses, active voice, condition before command') plus a full list of target document types. This matches the 'lists multiple specific concrete actions; comprehensive coverage' anchor, and stays in third person ('Enforces...') as required.

5 / 5

Completeness

It explicitly answers both questions: what ('Write or rewrite technical text with the rules of ASD-STE100... so it is clear, unambiguous, and free of AI slop') and when ('Use for documentation, READMEs...'; 'Also use when the user says "STE"...'). Both are concrete and explicit, matching the 'clearly and explicitly answers both what AND when with concrete trigger phrases' anchor.

5 / 5

Trigger Term Quality

Covers the formal names users would say ('STE', 'Simplified Technical English', 'ASD-STE100') plus natural colloquial phrases ('de-slop', 'make this readable', 'write for non-native readers', 'docs that translate well') and a dozen document-type keywords (READMEs, runbooks, incident reports, release notes). This is comprehensive natural-term coverage with synonyms, matching the top anchor; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The controlled-language niche is clear and the STE/ASD-STE100/de-slop triggers are distinctive, but generic phrases like 'make this readable' could also fire for a general editing or prose-polish skill. This sits between 'clear niche with distinct triggers; minimal conflict risk' (5) and 'mostly distinct; minor overlap risk with closely related skills' (4) — the generic triggers tip it to 4.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository
TanStack/ai
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.