CtrlK
BlogDocsLog inGet started
Tessl Logo

nature-experiment-log

标准化实验日志记录——直接上传或读取本地图片、语音和文字,产出带 YAML frontmatter 的 Markdown;可选集成飞书 CLI 与 Obsidian。

56

Quality

70%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/nature-experiment-log/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured, mostly executable guide: concrete ID grammar, device codes, output paths, and exact CLI commands, with user-confirmation checkpoints in the workflow. Its main weaknesses are a padded Obsidian explainer, a vague vision_analyze step, and broken file references — the templates/*.md files named in the integration table are absent from the bundle, so a user following the setup instructions hits missing files.

Suggestions

Add the missing templates/ files (experiment-index.md, anomaly-log.md, equipment-tracking.md) or fix the references so the Obsidian setup table points to files that actually ship with the skill.

Trim the '为什么用 Obsidian' rationale and the Obsidian-definition sentence — Claude already knows what Obsidian and Dataview are; keep only the vault file-layout requirements.

Make step 2 of the processing flow concrete: specify which frontmatter fields to extract per media type, or point to one of the references/ examples as the canonical field schema, and disambiguate the 'wiki/实验日志/...' rows in the 相关文件 table as user-created vault files rather than bundle files.

DimensionReasoningScore

Conciseness

The body is largely lean — ID-format diagrams, a device-code table, concrete output paths, and exact lark-cli commands with a ⚠️ pitfall note all earn their tokens. Minor trimming is possible: "Obsidian 是一个基于本地 Markdown 文件的笔记系统" and the "为什么用 Obsidian" bullet list explain concepts Claude already knows. This is the anchor for 'efficient; minor instances of over-explanation', not 3 (the padding is confined to one section) and not 5 (that Obsidian explainer is genuinely unnecessary).

4 / 5

Actionability

Guidance is mostly executable: exact output paths ("{OUTPUT_ROOT}/实验日志/{体系}/{类型}/{exp_id}.md"), fully specified ID grammar for exp_id and sample_batch, a device-code lookup table, and copy-paste lark-cli commands including the relative-path caveat. Minor gaps keep it below 5: step 2 "通过 vision_analyze 和文本解析提取结构化信息" is direction rather than instruction, and no example frontmatter schema is shown inline (though three complete examples live in references/).

4 / 5

Workflow Clarity

The 8-step 处理流程 is a clear sequence with explicit checkpoints: step 3 requires confirming ambiguous fields with the user ("不猜测实验条件或结果"), step 4 confirms output mode and directory before writing ("未指定目录时,先返回可保存的 Markdown,不擅自选择路径"), and step 8 reports generated file locations. This is not a destructive/batch operation skill, so the validation cap does not apply; it falls short of 5 only because there is no post-write verification (e.g. confirming the written file's links/frontmatter are valid).

4 / 5

Progressive Disclosure

The references/ examples are well handled — a dedicated section with a table mapping each of the three real files to its experiment type, one level deep. However, the body references "templates/experiment-index.md", "templates/anomaly-log.md", and "templates/equipment-tracking.md" which do not exist in the bundle, and the "相关文件" table lists "wiki/实验日志/..." vault files as if they were bundle files. This matches the anchor 'references present but not clearly signaled; content that should be separate is inline' — structure exists, but navigation is broken in places, so it is not 4.

3 / 5

Total

15

/

20

Passed

Description

58%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 communicates a clear, fairly specific capability set (multimodal experiment-log ingestion producing structured Markdown, with optional Feishu/Obsidian integration) but lacks an explicit 'Use when' trigger clause and natural synonym coverage, which limits when-to-use signal. It is specific enough to distinguish the skill from generic document skills but would benefit from explicit trigger phrasing.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user mentions 实验日志、记录实验、lab notebook, or uploads experiment photos/audio/notes'.

Include natural synonyms and input variations users would actually say (实验记录、记录实验、实验笔记) to broaden trigger coverage.

Briefly surface one concrete output artifact (e.g. the exp_id naming scheme or {OUTPUT_ROOT}/实验日志/ path) to sharpen the 'what'.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "直接上传或读取本地图片、语音和文字" (ingest local images/audio/text), "产出带 YAML frontmatter 的 Markdown" (produce frontmattered Markdown), "可选集成飞书 CLI 与 Obsidian" — matching the anchor for several specific actions with minor gaps. It falls short of 5 because what "标准化" (standardization) concretely involves (ID rules, indexing, archiving raw materials) is not surfaced, and it is above 3 because more than 1-2 actions are named.

4 / 5

Completeness

The 'what' is clear (standardized experiment logging producing Markdown with YAML frontmatter), but there is no 'Use when...' clause or equivalent explicit trigger guidance — when to load it is only weakly implied by naming the input channels. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3; it is above 2 because the 'what' half is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant keywords are present ("实验日志", "图片、语音和文字", "飞书", "Obsidian", "Markdown") but common variations a user would naturally say are missing — e.g. "实验记录", "记录实验", "lab notebook", or file-extension triggers. This matches the anchor 'some relevant keywords but missing common variations or synonyms'; not 4 because the natural-phrase coverage is thin beyond the single phrase 实验日志.

3 / 5

Distinctiveness Conflict Risk

The combination of experiment-log standardization with Feishu CLI and Obsidian integration carves a fairly distinct niche with domain-specific triggers (实验日志, 飞书群消息, vault). It is not 5 because generic phrasing around 图片/语音/文字 ingestion could overlap with general note-taking or file-organization skills.

4 / 5

Total

14

/

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

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository
Yuan1z0825/nature-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.