CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

transcript-fixer

Corrects ASR/STT transcription errors — homophones, garbled terms, person-name errors, mixed Chinese/English — with dictionary rules plus Claude's built-in AI, no external API key required. Use to clean meeting notes, lecture transcripts, interviews or speech-recognition text, even when the user only says "fix this transcript". Not for structuring a clean transcript into minutes (use meeting-minutes-taker).

Quality

89%

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

85%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 a well-engineered operational core: executable quick-start commands, a fully specified JSON contract, a clearly sequenced checklist with real validation gates, and exemplary progressive disclosure through verified, well-organized reference files. Its main weakness is token efficiency — the Stage-1-incompleteness contract is restated many times and several contract bullets are over-long run-ons that impose avoidable parsing cost.

Suggestions

State the "Stage 1 alone is incomplete; Native AI Correction is the default" contract once in the Operating contract section and reference it from elsewhere (e.g., the JSON field note, the caller contract, and the finalization rules) instead of restating it in five places.

Split the longest operating-contract bullets (the unfamiliar-token/rung-7 bullet and the name-roster bullet) into shorter labeled rules, or move their detail into the references they already cite and keep one-line summaries inline.

Trim redundant restatements of validation policy: 'Detection and enqueueing are not correction', 'Do not infer no-op or success from whether a sidecar exists', and the zero-pending rule appear in multiple sections and could be consolidated into the checklist's validation step.

DimensionReasoningScore

Conciseness

There is no generic-concept padding — every statement is project-specific policy — but the core "Stage 1 alone is incomplete / Native AI is the default" contract is repeated across at least five sections (lines 18, 22, 93, 136, 147), and several operating-contract bullets (e.g., the unfamiliar-token and name-roster bullets) are dense multi-clause run-ons. This fits anchor 3's "mostly efficient but could be tightened" better than anchor 4's "minor instances that could be trimmed".

3 / 5

Actionability

Copy-paste-ready commands cover the common cases: `uv run scripts/fix_transcription.py --init`, single- and multi-domain Stage 1 invocations with flags, `--dry-run`, `--scan-traps`, and a canonical caller call, plus a fully specified Stage 1 JSON output contract with per-field semantics. This matches anchor 5's fully executable, common-case-covering guidance.

5 / 5

Workflow Clarity

The Native correction checklist gives a clear numbered 1–6 sequence with explicit validation gates ("require zero pending for final/high-quality claims", "exact-file `stats.pending_total == 0`", read-back of edits) and feedback loops for error recovery (cold review, queue adjudication, evidence escalation). Batch/destructive-adjacent operations do have validation, so the workflow-clarity cap does not apply; this matches anchor 5.

5 / 5

Progressive Disclosure

The body is an overview that splits detail into one-level-deep reference files, all of which exist in references/ (including the deep-linked anchor sections, which were verified), navigable via three well-labeled tables (Choose the route, Conditional actions, Reference map). No bulk reference content is inlined and no nested-reference chains block navigation, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

87%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 strong: it states concrete capabilities with specific error types, gives explicit and natural use-when triggers (including the literal user phrase "fix this transcript"), and proactively fences off the neighboring meeting-minutes skill. The only minor gaps are a few missing natural synonyms (captions, subtitles, dictation) and slight under-representation of the full action coverage the body provides.

DimensionReasoningScore

Specificity

Names the domain and several concrete capabilities ("homophones, garbled terms, person-name errors, mixed Chinese/English — with dictionary rules plus Claude's built-in AI"), matching anchor 4's several specific actions with minor gaps; it stops short of anchor 5's comprehensive coverage since body-level actions like number repair, timestamp fixing, and batch processing are absent.

4 / 5

Completeness

Explicitly answers both what ("Corrects ASR/STT transcription errors — homophones, garbled terms, person-name errors, mixed Chinese/English") and when ("Use to clean meeting notes, lecture transcripts, interviews or speech-recognition text, even when the user only says 'fix this transcript'") with concrete trigger phrases, matching anchor 5; it is not anchor 4 because the when-clause is fully explicit, not merely present.

5 / 5

Trigger Term Quality

Strong natural phrases users would say — "meeting notes, lecture transcripts, interviews or speech-recognition text, even when the user only says 'fix this transcript'" — plus the technical terms ASR/STT. A few natural synonyms (captions, subtitles, dictation) are missing, so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Clear ASR/transcript-correction niche with distinct triggers and an explicit disambiguation boundary ("Not for structuring a clean transcript into minutes (use meeting-minutes-taker)"), giving minimal conflict risk — anchor 5. It exceeds anchor 4 because overlap risk is addressed proactively, not just reduced.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

daymade/claude-code-skills

Path

daymade-audio/transcript-fixer/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.