CtrlK
BlogDocsLog inGet started
Tessl Logo

ljg-read

Reading companion agent. Accompanies user through any text (books, articles, essays, papers, news) with translation, structural annotation, deep questioning, and cross-domain insights. Detects language, translates English to Chinese (faithfulness-expressiveness-elegance), guides reader to understand the author and encounter real questions. Use when user says '伴读', '陪我读', '读这篇', 'read with me', 'companion read', or shares a text/URL wanting guided reading.

74

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

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.

A richly specified, well-sequenced reading-companion workflow with concrete decision trees, feedback loops, and executable file-writing commands. Its main weakness is progressive disclosure: everything lives in one long SKILL.md with no reference files to offload detailed material.

Suggestions

Move the detailed translation-operation rules (semantic segmentation, terminology strategy, cultural translation) and the org-mode file template into separate reference files (e.g. references/translation.md, references/org-template.org) linked from the main body, so SKILL.md stays a lean overview.

Trim the poetic opening and '核心理念' philosophy to one or two lines, or relocate them to a reference file, to tighten conciseness.

Consider extracting the text-type × questioning-anchor table and the success-criteria rubric into a references/cheatsheet.md so the core phase flow reads more quickly.

DimensionReasoningScore

Conciseness

Dense and mostly efficient — it does not explain concepts Claude already knows and packs each section with actionable methodology. Minor instances of flavor/poetic padding ('不是替你读,是陪你走进去', '核心理念') and principle prose could be trimmed. Not a 5 because those philosophical openings and some principle bullets are tokens that don't directly advance execution.

4 / 5

Actionability

Highly actionable for an instruction-only skill: concrete three-layer translation output, explicit paragraph tags [骨][肌][筋], decision-tree branches keyed to reader replies, and copy-paste-ready shell commands ('date +%Y%m%dT%H%M%S') with an exact file-path template and org-mode structure. The rubric notes absence of code is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

Phases 0–4 are clearly sequenced with explicit feedback loops ('翻译后自动停下,进入 Phase 2', '接不住 -> 回到注疏', '回到 Phase 1 下一段') and a validation checkpoint (the L0–L3 '读后一句话' assessment acts as a success check). Not a 4 because loops and checkpoints are explicit throughout.

5 / 5

Progressive Disclosure

Well-organized with clear section headers and logical flow, but it is a ~265-line monolithic file with no bundle files and no external references; content such as the org-mode template, detailed translation-operation rules, and success criteria are inlined rather than split. Not a 4 because nothing is offloaded to one-level-deep reference files, and the under-50-line exception does not apply.

3 / 5

Total

17

/

20

Passed

Description

100%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, third-person description that concisely states concrete capabilities and gives explicit, natural bilingual trigger phrases. It clearly answers both what the skill does and when to invoke it.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'translation, structural annotation, deep questioning, and cross-domain insights', 'Detects language, translates English to Chinese', 'guides reader to understand the author and encounter real questions' — giving comprehensive coverage of what the skill does.

5 / 5

Completeness

Explicitly answers both 'what' (translation, annotation, questioning, cross-domain insights) and 'when' via a concrete 'Use when user says ...' clause with multiple trigger phrases.

5 / 5

Trigger Term Quality

Comprehensive natural trigger phrases in both languages — '伴读', '陪我读', '读这篇', 'read with me', 'companion read' — plus the behavioral cue 'shares a text/URL wanting guided reading', covering synonyms a user would actually say.

5 / 5

Distinctiveness Conflict Risk

Clear niche (English-to-Chinese guided reading companion) with distinctive bilingual trigger phrases; minimal overlap risk with other skills. Not a 4 because the EN→CN companion framing and specific triggers make conflict unlikely.

5 / 5

Total

20

/

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.

Validation15 / 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
lijigang/ljg-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.