CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

family-health-analyzer

分析家族病史、评估遗传风险、识别家庭健康模式、提供个性化预防建议

Quality

64%

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 ./skills/family-health-analyzer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 presents a clear, well-sequenced 8-step analysis workflow with good safety boundaries and an explicit validation step, but its core algorithm is unexecutable pseudocode and it carries minor padding (a duplicated overview and a dated version footer). It is a solid mid-to-good skill whose main gaps are executable detail and a missing validation feedback loop.

Suggestions

Replace the pseudocode risk formula with executable Python (real variable names, defined inputs) so the scoring step can be run directly.

Add a validation feedback loop: specify concrete checks (e.g., age ranges, relationship rules) and what to do when validation fails before proceeding to risk calculation.

Remove the '技能版本/最后更新' footer and the '技能概述' section that duplicates the description, moving any needed detail into a references file to keep the main body lean.

DimensionReasoningScore

Conciseness

The body is mostly efficient lists, but the '技能概述' section restates the frontmatter description nearly verbatim, and the '技能版本: v1.0 / 最后更新: 2025-01-08' footer is time-sensitive metadata that penalizes conciseness per the guidelines. Not 4 because the duplication and date/version footer are noticeable padding, though limited in extent.

3 / 5

Actionability

Concrete elements exist (specific data file paths, a JSON suggestion example, named report components), but the central risk-scoring formula is pseudocode with Chinese variable names that cannot execute, and report generation has no code or commands. This matches the 'pseudocode instead of executable code; missing key details' anchor rather than the mostly-executable level of 4.

3 / 5

Workflow Clarity

Eight steps are clearly sequenced with an explicit validation step (步骤3 数据验证与清洗), matching 'clear sequence with most checkpoints present'. Not 5 because there is no error-recovery path when validation fails and validation criteria (关系完整性, 年龄合理性, 数据一致性) are named without thresholds or procedures; not 3 because a validation checkpoint is explicitly present rather than implicit.

4 / 5

Progressive Disclosure

A well-sectioned single file with no nested or buried references, and at ~130 lines nothing clearly belongs in a separate file, matching 'good structure; most content appropriately placed'. Not 5 because there is no reference structure at all — details like report templates or the fixed disclaimer text could be offloaded to one-level-deep reference files to slim the main skill.

4 / 5

Total

14

/

20

Passed

Description

55%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 set of capabilities in a distinct domain, but it omits any usage/trigger guidance and its keyword coverage is narrow relative to how users would naturally phrase family-health requests. It is functional but below the standard of the good reference examples, all of which pair a capability list with explicit 'Use when' triggers.

Suggestions

Append an explicit trigger clause, e.g. '当用户提到家族病史、家族史、遗传风险、基因或家庭健康报告时使用本技能', to lift completeness and trigger-term quality.

Add natural synonym keywords users would actually say (家族史, 基因, 遗传咨询, 健康趋势) to broaden trigger coverage.

Mention the concrete output artifact (HTML 可视化报告) in the description to close the specificity gap with the body's demonstrated capabilities.

DimensionReasoningScore

Specificity

The description lists four concrete verb+object actions ('分析家族病史、评估遗传风险、识别家庭健康模式、提供个性化预防建议'), matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because it omits demonstrated capabilities like HTML/visualization report generation, and stays above 3 because it goes beyond 1-2 generic actions.

4 / 5

Completeness

The 'what' is clear (four enumerated capabilities) but there is no 'Use when...' clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because 'when' is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

'家族病史' and '遗传风险' are natural phrases users would say, but common synonyms and variations ('家族史', '基因', '健康趋势', '体检') are missing. Coverage is thinner than the 'good keyword coverage' anchor of 4.

3 / 5

Distinctiveness Conflict Risk

The family-health/genetic-risk niche is somewhat specific, but the skill body integrates sibling hypertension/diabetes trackers, so a user asking about blood pressure or blood sugar trends could plausibly trigger this skill by mistake. This matches the 'could still overlap with similar skills' anchor rather than the 'minor overlap risk' of 4.

3 / 5

Total

13

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/family-health-analyzer/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.