CtrlK
BlogDocsLog inGet started
Tessl Logo

tts-error-reporting

Convention for reporting errors from multiprocessing TTS workers to the main process frontend. Use this skill when modifying, adding, or debugging TTS workers in tts_client.py to ensure connection errors, quotas, and API limits correctly display Toast notifications to the user rather than failing silently.

68

Quality

83%

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

78%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 tight, well-structured skill: one unambiguous core rule, contrastive code examples, and a sequenced checklist for the main workflow. The remaining gaps are small — the i18n error-code list is assumed rather than documented, and no step verifies the toast reaches the user.

Suggestions

Document the recognized i18n error codes (e.g., a short mapping of API_QUOTA_TIME, API_1008_FALLBACK, and any others) so the 'Good Pattern' is fully copy-paste ready without guessing the code vocabulary.

Add a final checklist step to verify the propagated error actually renders as a toast (e.g., confirm tts_response_handler in core.py handles the emitted code), closing the workflow's validation gap.

Collapse the three except-block examples into one canonical pattern with inline comments for the fallback variant to remove the repeated logger.error/json.dumps skeleton.

DimensionReasoningScore

Conciseness

The body is lean with no padding of concepts Claude already knows, but the three example patterns ('Bad', 'Good', 'Acceptable Fallback') repeat the same logger.error + json.dumps + response_queue.put skeleton, and the '(Fallback 1008 error if code unknown)' comment is cryptic. Efficient with minor instances that could be trimmed — the 4 anchor, not the fully lean 5.

4 / 5

Actionability

Provides the exact tuple format, executable bad/good/fallback code patterns, a WebSocket callback example, and a concrete 4-step checklist. However, the i18n error-code vocabulary ('API_QUOTA_TIME', 'API_1008_FALLBACK') is referenced but never enumerated, leaving a gap for copy-paste-ready use — mostly executable with minor gaps, so 4 rather than 5.

4 / 5

Workflow Clarity

The 'Checklist for Adding a New TTS Worker' gives a clear, ordered sequence (signature → locate blocks → add puts → encoding) and the core rule is unambiguous with MUST emphasis. There is no verification step confirming the error actually surfaces as a toast in the frontend, a minor validation gap that keeps it at 4; this is not a destructive/batch operation, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

The body is under 50 lines with well-organized sections (Core Rule, Example Implementation, WebSocket Callbacks, Checklist) and no bundle files exist, so nothing needs external referencing. Per the rubric's simple-skill guideline, this earns a 5 on organization alone.

5 / 5

Total

17

/

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.

A strong description: it states a precise convention, includes an explicit and specific 'Use this skill when…' trigger clause naming the target file and activities, and covers the error categories and user-facing outcome. The only improvements are minor — spelling out 'text-to-speech' for trigger matching and mentioning the response_queue mechanism.

DimensionReasoningScore

Specificity

Names the domain and several concrete elements — 'reporting errors from multiprocessing TTS workers to the main process frontend', 'connection errors, quotas, and API limits', 'Toast notifications' — but stops short of a comprehensive action list (e.g., the queue mechanism is only implied). It lists several specific capabilities with minor gaps, matching the 4 anchor rather than the comprehensive 5 anchor.

4 / 5

Completeness

Explicitly answers both parts: the 'what' ('Convention for reporting errors from multiprocessing TTS workers to the main process frontend') and a concrete 'when' ('Use this skill when modifying, adding, or debugging TTS workers in tts_client.py'). This mirrors the 5 anchor's structure of what plus explicit trigger phrases; the 4 anchor requires a 'when' that 'could be more explicit', which does not apply here.

5 / 5

Trigger Term Quality

Good natural keyword coverage — 'modifying, adding, or debugging TTS workers', 'tts_client.py', 'quotas', 'connection errors', 'Toast notifications' — but common variations like 'text-to-speech' spelled out, 'speech synthesis', or 'error handling' are missing. Good coverage with a few natural terms absent, so 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — TTS worker error propagation in a specifically named file (tts_client.py) — with distinct trigger phrases, so it is unlikely to fire for unrelated skills. Matches the 5 anchor 'clear niche with distinct triggers; minimal conflict risk'.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Project-N-E-K-O/N.E.K.O
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.