CtrlK
BlogDocsLog inGet started
Tessl Logo

text-format-organizer

A local text formatting organizer for biomedical/academic writing; use it when you need to clean whitespace/line endings while preserving Markdown structures or when normalizing .docx/.md/.txt before submission or proofreading.

55

Quality

69%

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 ./scientific-skills/Other/text-format-organizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

48%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 core usage documentation (examples, CLI table, formatting rules) is concrete and well-organized, but the body is bloated with generic template boilerplate and undermined by references to script files that are missing from the bundle and a fabricated expected output for the validation shortcut. Trimming the filler and making the execution path real would substantially improve it.

Suggestions

Delete the generic template sections ('When Not to Use', 'Required Inputs', 'Recommended Workflow', 'Output Contract', 'Validation and Safety Rules', 'Failure Handling', 'Input Validation', 'Deterministic Output Rules', 'Completion Checklist') — they contain no skill-specific information and roughly halve the body.

Ship the referenced `scripts/init_run.py` and `scripts/text_formatter.py` in the bundle, or remove all references to them; a documented execution path that cannot be run is the biggest actionability gap.

Merge the duplicate 'Validation Shortcut' and 'Quick Validation' sections into one, and replace the fabricated `--help` expected output with the actual usage text (or point to `--preview` as the real pre-flight check).

DimensionReasoningScore

Conciseness

Roughly half the ~190-line body is generic template boilerplate that adds no skill-specific information Claude doesn't already know: "Validate required inputs before execution and stop early when mandatory fields or files are missing", "Do not fabricate measurements, references, findings, or conclusions", "Confirm the final deliverable matches the documented format exactly". Sections like 'When Not to Use', 'Required Inputs', 'Output Contract', 'Validation and Safety Rules', 'Failure Handling', 'Deterministic Output Rules', and 'Completion Checklist' are abstract filler, and the same `python scripts/init_run.py --help` validation command appears in two separate sections. This matches anchor 2 ("Noticeably verbose; several unnecessary explanations or padded sections") — the core usage/reference material is efficient, but the padding is extensive, keeping it above anchor 1 only because the examples and parameter table are genuinely useful.

2 / 5

Actionability

The body provides concrete, specific commands ("python scripts/init_run.py --input input.md --output output.md", "--line-ending", "--indent-size"), a complete CLI parameter table, and an executable-looking programmatic example — but key details are missing or wrong: the referenced `scripts/init_run.py` and `scripts.text_formatter` files do not exist in the skill's bundle (no scripts/ directory), so the documented execution path cannot actually be run, and the 'Expected output format' claimed for `--help` ("Result file: text_format_organizer_result.md / Validation summary: PASS/FAIL") is fabricated — a help flag would print usage text, not a result-file summary. This lands at anchor 3 ("Some concrete guidance but incomplete... missing key details") rather than 4, since the guidance only appears executable.

3 / 5

Workflow Clarity

The main execution path is a single, unambiguous command demonstrated in multiple concrete variants (format md/docx, preview), and `--preview` ("Preview changes without writing output") provides a genuine check-before-write checkpoint, plus a concrete two-step workflow with the downstream proofreading tool. It is a 4 rather than 5 because the 'Recommended Workflow' steps are abstract ("Select the documented execution path and prefer the simplest supported command"), validation guidance is duplicated across two sections, and the documented validation shortcut's expected output is fabricated, so the checkpoint as written would mislead. Not a 3: the actual operation is clearly sequenced and verifiable via preview.

4 / 5

Progressive Disclosure

The body has clear section headers and one-level-deep references to script files, but no bundle files exist — `scripts/init_run.py` and `scripts/text_formatter.py` are referenced yet absent, making navigation broken at the most important point. Additionally, ~100 lines of generic boilerplate ('Output Contract', 'Completion Checklist', etc.) are inlined that should simply be cut rather than split out. This matches anchor 3 ("Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline") — not 2 because the getting-started and reference material itself is well sectioned, not a headerless wall.

3 / 5

Total

12

/

20

Passed

Description

78%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, well-scoped description that clearly states both capability and trigger conditions with concrete file extensions and a defined domain. Its weaknesses are the second-person phrasing in the trigger clause ("use it when you need to") and missing common synonyms for the cleanup actions.

Suggestions

Rewrite in third-person voice to match the guideline, e.g. "Cleans whitespace and line endings while preserving Markdown structures; normalizes .docx/.md/.txt. Use when formatting biomedical/academic manuscripts before submission or proofreading."

Add natural synonyms users would say, such as "fix spacing", "trailing spaces", "mixed line endings", or "manuscript cleanup", to strengthen trigger-term coverage.

Mention the tab-to-space and table-preservation capabilities to close the coverage gap in the 'what' statement.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "clean whitespace/line endings while preserving Markdown structures" and "normalizing .docx/.md/.txt" — which on anchor fit alone lands at 4 ("Lists several specific actions; minor gaps in coverage", e.g. no mention of tab conversion or tables). However, the trigger clause "use it when you need to clean whitespace" addresses the reader in second person, and the judging guidelines explicitly penalize non-third-person voice by reducing specificity by 1, bringing it to 3. It is not a 2 because the domain ("biomedical/academic writing") and file formats are named with real actions, well above "Names the domain but actions are minimal".

3 / 5

Completeness

Both questions are explicitly answered with concrete trigger phrases: what — "A local text formatting organizer for biomedical/academic writing... clean whitespace/line endings while preserving Markdown structures"; when — "use it when you need to clean whitespace/line endings... or when normalizing .docx/.md/.txt before submission or proofreading". This matches the anchor-5 good example pattern ("Extract text... Use when working with PDF files or when the user mentions PDFs"). Not a 4, since the 'when' clause is not merely present but specific and multi-condition.

5 / 5

Trigger Term Quality

Good natural-term coverage: "clean whitespace", "line endings", "normalizing .docx/.md/.txt", "before submission or proofreading", "biomedical/academic writing" — users needing manuscript cleanup would plausibly say these. It is a 4 rather than 5 because common synonyms and phrasings are missing (e.g. "fix spacing", "tidy up formatting", "manuscript cleanup", "trailing spaces"), and "formatting organizer" is somewhat formal rather than natural user speech.

4 / 5

Distinctiveness Conflict Risk

The "biomedical/academic writing" scope plus explicit extensions (.docx/.md/.txt) and the Markdown-preservation angle give it a clear niche with distinct triggers, mostly matching anchor 4 ("Mostly distinct; minor overlap risk with closely related skills"). It is not 5 because "text formatting" is broad and could overlap with generic Markdown linters/formatters or a proofreading skill; not 3 because the domain and trigger conditions are far more specific than "Works with document files".

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository
aipoch/medical-research-skills
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.