CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grounded-protocol

基于科学依据的微协议生成,为空闲时段设计行动方案

Quality

63%

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/grounded-protocol/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 coherent, well-structured prompt template with a complete output schema and a useful protocol taxonomy, but it under-specifies its own decision logic: the connection-protocol family has no selection rule, and the hard JSON-validity constraint has no validation checkpoint. A redundant bilingual notes section duplicates earlier constraints and pushes the file past lean-skill size. These are fixable gaps in an otherwise sound single-file skill.

Suggestions

Add a selection rule for the third protocol family (e.g., 'If the context involves other people or social energy, design a connection protocol'), and a final checkpoint like 'Verify output is valid JSON matching the schema before responding' — this addresses the two workflow_clarity gaps.

Delete or merge the 注意事项 section, since three of its four bullets restate the Constraint section verbatim — this trims redundancy and tightens conciseness.

Include one worked example of a completed output JSON (e.g., a filled NSDR Reset protocol) to anchor the schema and push actionability toward copy-paste readiness.

DimensionReasoningScore

Conciseness

The body is mostly efficient — role, task, constraints, input context, output schema, and a compact protocol taxonomy, with no padding explaining things Claude already knows. However, the 注意事项 section largely restates constraints already given ('所有建议必须有明确的科学依据' duplicates 'Strict Grounding', '避免模糊的建议' duplicates 'Avoid generic advice'), which is unnecessary explanation that could be trimmed. This fits 'Mostly efficient but includes some unnecessary explanation or could be tightened', not 4 because the redundancy is a real (if small) block rather than a minor instance.

3 / 5

Actionability

As an instruction-only skill it gives concrete, specific guidance: a complete JSON output schema with field-level examples, an explicit micro-step format ('Do X for Y mins'), strict grounding rules, and a concrete taxonomy of protocol families (NSDR, 冥想, 深度工作启动仪式...). This matches 'Mostly executable guidance; concrete code or commands with minor gaps' — the gap being no worked example of a filled output JSON and no specified step count/duration calibration, so it does not reach 5's copy-paste-ready, common-cases-covered level.

4 / 5

Workflow Clarity

The structure implies a rough sequence (read [CONTEXT] → apply philosophy → emit JSON), but the core decision logic is incomplete: the Philosophy section maps only two branches (context suggests rest → recovery; context suggests focus → engagement) while the taxonomy lists a third family (连接型/connection) with no rule for when to choose it. There is also no checkpoint validating the output (e.g., 'verify JSON fits schema before responding'), even though valid JSON output is a hard constraint. This matches 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit' — not 4, because the missing connection-protocol branch and absent output validation are substantive gaps rather than minor ones. No destructive/batch cap applies.

3 / 5

Progressive Disclosure

No bundle files exist, and this self-contained prompt template has no need for external references; its well-labeled sections (Role, Task, Constraint, Input Context, Output Schema, Philosophy, typed protocol sections) make navigation easy. The body is ~63 lines — just past the 'under 50 lines' threshold where well-organized sections alone earn a 5 — and the inlined protocol taxonomy plus the duplicated constraint section could be flattened or split. This fits 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps' rather than the clear-overview-with-signaled-references anchor.

4 / 5

Total

14

/

20

Passed

Description

50%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 niche concept (grounded micro-protocols for idle time) but does so in abstract, coined vocabulary without explicit 'use when' trigger guidance or concrete capability enumeration. It reads more like a title than an actionable, trigger-rich description. All four dimensions land at 3 for the same root cause: too much abstraction, not enough concrete action and trigger phrases.

Suggestions

Add an explicit trigger clause, e.g. '使用时机:用户处于空闲/未安排时段,需要休息恢复或高效利用空隙时间时使用' — this directly lifts the completeness cap.

Enumerate concrete capabilities instead of the abstract '行动方案', e.g. '生成恢复型(NSDR、冥想)、专注型(深度工作、学习冲刺)、连接型协议,输出可执行的分步行动方案' — this raises both specificity and trigger-term quality.

Include natural synonyms users would actually say — 空闲时间、休息、恢复、日程空档、碎片时间 — so the skill triggers on varied phrasing.

DimensionReasoningScore

Specificity

The description names the domain ('微协议生成' — micro-protocol generation) and one concrete action ('为空闲时段设计行动方案' — design action plans for idle time slots), which matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not reach 4 because it lists no additional concrete actions (e.g., recovery protocols, focus protocols, JSON output) and is not below 3 because it is more specific than 'Processes PDF files'-level generality.

3 / 5

Completeness

The 'what' is reasonably clear (generate science-grounded micro-protocols / design action plans), but the 'when' is only weakly implied: '为空闲时段' states the target context rather than giving explicit trigger guidance, and there is no 'Use when...' clause or equivalent ('使用时机' guidance). Per the judging guideline, a missing explicit 'Use when...' clause caps completeness at 3, which also matches the anchor 'Has a clear what but when is missing or only weakly implied'.

3 / 5

Trigger Term Quality

There are some relevant keywords a user might echo ('空闲时段' — idle time slots, '行动方案' — action plan), but '微协议' (micro-protocol) is a coined technical term users would not naturally say, and common synonyms like 休息/恢复 (rest/recovery), 日程空档 (schedule gaps), or 空闲时间 variations are absent. This fits 'Some relevant keywords but missing common variations or synonyms'; it is not a 2 because '空闲时段' is a genuinely natural trigger phrase, not pure jargon.

3 / 5

Distinctiveness Conflict Risk

The niche is somewhat distinct — the coined term '微协议' and the idle-time-slot framing ('为空闲时段') would not collide with document or file skills — but the generic action language ('设计行动方案' — design action plans) plus '科学依据' (science-based) could overlap with productivity, planning, or study-skills skills. This sits between anchors 3 and 4; it stays at 3 rather than 4 because the coverage of 'action plan design' language is broad enough to risk overlap with closely related productivity/planning skills.

3 / 5

Total

12

/

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.

Validation — 15 / 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

ooooooooooooooooooop/ai_life_os

Path

skills/grounded-protocol/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.