CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

asd-ste100

Use when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and misreading has a real cost, or when text reads as dense, hedged, or easy to misparse. Triggers: disambiguate, STE100 rewrite, apply Simplified Technical English, plain-language rewrite, controlled-language rewrite, rewrite so an agent cannot misread this. Not for creative or marketing copy.

Quality

72%

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 ./.cursor/skills/asd-ste100/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 strong, disciplined instruction skill with excellent rule tables, a concrete checklist, and a bundled verification linter integrated into the workflow. Its weaknesses are duplicated linter documentation inflating token cost, a dangling reference to a nonexistent examples file, and no post-rewrite validation that meaning and hedges survived.

Suggestions

Document the linter once — keep the flag reference in Additional Resources (or a scripts/README) and reduce Process step 3 to the single invocation and what it covers.

Fix the progressive-disclosure defect: either add examples/before-after.md with the promised worked examples or remove both references to it (lines in Source and Scope and Additional Resources).

Add a final verification step to the Process: after rewriting, re-check that every hedge, condition, and scope qualifier from the original survived unchanged (the linter's no-hedge-flags behavior or a manual pass would serve).

DimensionReasoningScore

Conciseness

Most of the body is genuinely skill-specific (rule tables, scan checklist, modality warnings) rather than concepts Claude already knows, but there is avoidable repetition: the ste-lint flag documentation including the identical '--strict... default: advisory, because the linter cannot tell whether two verbs name the same action' sentence appears nearly verbatim in both Process step 3 and Additional Resources, and the structural/lexical split is explained three times (Two Modes, Source and Scope, Core Rewrite Rules). That fits anchor 3 (mostly efficient, could be tightened) rather than anchor 4.

3 / 5

Actionability

Concrete, executable guidance dominates: Do/Don't rule tables with examples, a six-item scan checklist with fixes, a numbered process, a copy-paste output-format table template, and a real bundled linter with documented flags (--json, --baseline, --disable, --strict, --selftest). It stops short of anchor 5 because no literal invocation line (e.g. 'python scripts/ste-lint.py input.md') is given, and the worked before/after examples that would cover common cases are pointed at a file that does not exist in the bundle.

4 / 5

Workflow Clarity

The six-step Process is clearly sequenced with real checkpoints: read for meaning before rewriting, a mechanical linter first pass, an explicit 'Check modality before you commit to a rewrite' gate, and a terminal compliance check (step 6). It misses anchor 5 because there is no post-rewrite verification step confirming meaning and hedges were preserved — the highest-risk failure mode for this skill is only guarded on the input side.

4 / 5

Progressive Disclosure

The section structure is good and references are one level deep and clearly signaled, but scoring against the actual bundle shows that of the three referenced paths, examples/before-after.md (cited in both Source and Scope and Additional Resources) does not exist — there is no examples/ directory — so navigation dead-ends for one of three resources. That broken reference is a concrete organization defect beyond the 'minor gaps' of anchor 4, while the overall structure is still better than the disorganized or buried-reference profile of anchor 3's typical case.

3 / 5

Total

14

/

20

Passed

Description

70%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 distinctive, trigger-rich description with an excellent 'use when' clause and explicit negative scope. Its main weakness is that the core capability — rewriting dense English into short, single-meaning sentences — is implied through triggers rather than stated, leaving the 'what' partially inferential.

Suggestions

Open with a third-person capability statement such as 'Rewrites dense or ambiguous English into short, single-meaning, active-voice sentences based on ASD-STE100 rules' before the 'Use when' clause, so the 'what' is explicit rather than inferred from triggers.

Add the natural user phrasings 'simplify', 'clarify', and 'plain English' to the trigger list to cover the most common ways a user would ask for this.

Consider one short clause naming the reader of the output (an AI agent or downstream parser) as the deliverable's consumer, which is currently only implied by 'parsed without a human'.

DimensionReasoningScore

Specificity

The description names concrete text types ("tool descriptions, error messages, inter-agent instructions, system prompts, status reports") but never states the skill's core action — rewriting text into unambiguous simplified English — except obliquely via trigger phrases like "STE100 rewrite" and "plain-language rewrite". It matches anchor 3 (domain plus limited concrete actions) better than anchor 4, which expects several specific actions to be listed as capabilities.

3 / 5

Completeness

The 'when' is answered explicitly and richly ("Use when English text must be parsed without a human to resolve ambiguity... and misreading has a real cost"), with a concrete Triggers list and a negative scope statement ("Not for creative or marketing copy"). The 'what' is present but weak — the rewriting action must be inferred from the trigger terms rather than read as a stated capability — so it sits at anchor 4 rather than anchor 5.

4 / 5

Trigger Term Quality

Trigger coverage is good and includes synonyms across registers ("disambiguate", "STE100 rewrite", "apply Simplified Technical English", "plain-language rewrite", "controlled-language rewrite", "rewrite so an agent cannot misread this") plus natural problem framings ("dense, hedged, or easy to misparse"). It falls short of anchor 5 because common phrasings like "simplify this text", "clarify", or "plain English" are absent.

4 / 5

Distinctiveness Conflict Risk

The controlled-language/STE niche with agent-facing triggers ("STE100 rewrite", "disambiguate") is mostly distinct and the explicit exclusion ("Not for creative or marketing copy") reduces overlap with writing-style skills. It is not anchor 5 because generic triggers like "plain-language rewrite" could plausibly fire for a general editing or simplification skill.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

mflux-community/mflux

Path

.cursor/skills/asd-ste100/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.