CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-style

Literature-backed English technical-prose writing rules (agent-style, 21 rules). Its lane is FORMAL technical prose (papers, design docs, proposals, READMEs, commit messages). Use ONLY when the user explicitly asks for agent-style by name (e.g. "apply agent-style", "write/revise this per agent-style rules", "iterate until agent-style clean"). NOT for de-AI-ing casual or voiced text — use remove-ai-patterns for that. Do not auto-trigger for ordinary prose or documentation tasks.

68

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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-structured ruleset skill: the body carries only compact actionable directives, externalizes the full rule bodies one level deep with a clear resolution order, and every instruction is concrete down to specific banned phrases and executable commands. The only trims needed are the maintainer-facing Updating section and a small piece of loader meta-commentary.

DimensionReasoningScore

Conciseness

The body is lean: 21 one-line directives with concrete banned phrases, no explanations of concepts Claude already knows. Minor trimmable content remains — the maintainer-facing 'Updating' section (~8 lines) and the meta note 'Frontmatter metadata is scanned eagerly at session start' do not serve the invoking agent. This is anchor 4 (efficient, minor instances that could be trimmed), not anchor 5, and well above anchor 3.

4 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: each rule pairs a directive with specific tokens ('in order to', 'pushes the boundaries', 'use' over 'leverage', 'proves' vs 'suggests'); the handshake gives a verbatim reply string; the CLI path is executable ('uv tool install agent-style', 'agent-style audit FILE'); and the reference resolution order names real paths. Matches anchor 5 — copy-paste-ready, specific direction covering the common cases.

5 / 5

Workflow Clarity

A simple single-purpose skill whose core action (apply the 21 rules when revising prose) is unambiguous, with a clearly sequenced 3-step resolution order for locating full rule bodies (project root → vendored snapshot → upstream). It falls short of anchor 5 because it never says when the compact directives suffice versus when to consult the full rule bodies in references/RULES.md. No destructive or batch operations, so no validation cap applies.

4 / 5

Progressive Disclosure

The body is a compact overview while the 814-line full rule set is appropriately externalized to references/RULES.md (verified to exist), alongside UPSTREAM-PIN, NOTICE.md, and LICENSES/CC-BY-4.0.txt — all real, one level deep, and clearly signaled with an explicit resolution order. The one out-of-bundle path (scripts/update-upstream.sh) is explicitly scoped to the plugin root as maintainer context, not navigation, so it does not break the structure. Matches anchor 5.

5 / 5

Total

18

/

20

Passed

Description

82%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 strongly written description: the what/when split is fully explicit, trigger phrasings are quoted verbatim, and conflict risk against a sibling skill is actively defused. The only real gap is specificity — the skill's own actions (revise/audit/apply rules to prose) are never stated as verbs, only implied through quoted user phrases.

Suggestions

State the skill's actions in the skill's own voice, e.g. 'Revises and audits formal technical prose against 21 literature-backed rules' — this would lift specificity from 3 toward 4-5.

Consider one or two natural synonyms beyond the skill name (e.g. 'formal technical writing style') so users who describe the task rather than naming the skill can still find it, if the by-name-only gating is not a hard requirement.

DimensionReasoningScore

Specificity

The description names the domain and artifact concretely ('Literature-backed English technical-prose writing rules (agent-style, 21 rules)', 'papers, design docs, proposals, READMEs, commit messages') but never states the skill's actions in its own words — the verbs only appear inside quoted user trigger phrases. This matches anchor 3 (domain plus 1-2 implied actions, not comprehensive); anchor 4 requires several specific actions listed by the skill itself.

3 / 5

Completeness

It explicitly answers both questions: what ('Literature-backed English technical-prose writing rules... Its lane is FORMAL technical prose') and when ('Use ONLY when the user explicitly asks for agent-style by name (e.g. "apply agent-style"...)'), with concrete trigger phrases. This is the anchor-5 pattern; it exceeds anchor 4 because the when-clause is maximally explicit with example phrasings.

5 / 5

Trigger Term Quality

It quotes natural user phrasings verbatim ('apply agent-style', 'write/revise this per agent-style rules', 'iterate until agent-style clean') plus concrete domain nouns (papers, design docs, commit messages). Good coverage but natural synonyms a user might say ('formal writing style', 'tighten this prose') are absent — deliberately gated to the skill name, which fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It is explicitly gated ('Use ONLY when the user explicitly asks for agent-style by name'), disambiguates against a named sibling skill ('NOT for de-AI-ing casual or voiced text — use remove-ai-patterns for that'), and forbids auto-triggering ('Do not auto-trigger for ordinary prose or documentation tasks'). Clear niche with distinct triggers and minimal conflict risk — anchor 5.

5 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository
pchalasani/claude-code-tools
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.