CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

calendar-ops-skill

当用户要对真实日历数据做查询或增删改时触发:看今天/本周安排、查冲突、建会议、改时间、删日程。典型说法"我明天几点开会"、"帮我约 xx"、"schedule a meeting"。**不用于**:对话里口头提到时间或倒计时(→直接回答)、周期性后台任务如"每天 9 点跑脚本"(→schedule-ops-skill)。

70

Quality

88%

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

81%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 well-structured, actionable skill body: concrete commands and field names, five clearly sequenced decision paths with explicit validation and confirmation checkpoints for destructive operations, and a strong pitfalls section. The main weaknesses are a redundant duplicate tool table and a couple of rationale notes that over-explain the obvious.

Suggestions

Merge the '工具清单' and '工具速查' tables into one table — they repeat the same tool/mode/action information and waste tokens.

Trim '为什么?' notes that state what Claude already knows (e.g., the double-booking rationale in Path B), keeping only the non-obvious ones like the silent timezone-offset failure mode.

Add one concrete example CalendarMutate create call payload (with sourceId, kind, and offset-bearing times) to make the most common operation copy-paste ready.

DimensionReasoningScore

Conciseness

The body is largely lean — exact commands, field names, and terse steps — but the tool table appears twice ('工具清单' and '工具速查') and a few '为什么' notes explain things Claude already knows (e.g., why double-booking is bad, '浪费所有人的时间,还让用户显得不专业'). These are minor trimmable instances, matching the 'efficient; minor over-explanation' anchor.

4 / 5

Actionability

Guidance is concrete throughout: the exact bash command `date '+%Y-%m-%dT%H:%M:%S%z'`, tool modes (`list-sources`/`list-items`), actions (`create`/`update`/`delete`/`toggle-completed`), and required fields (`sourceId`, `itemId`, `kind`, `allDay`, ISO 8601 with timezone offset). It falls short of fully copy-paste ready because no complete example tool payload is shown for the common create case.

4 / 5

Workflow Clarity

Paths A–E give clearly sequenced steps with explicit validation checkpoints: conflict check before create and time-change update, mandatory user confirmation before the destructive delete ('删除不可逆,必须让用户明确同意'), candidate listing on ambiguous matches, and follow-up questions when key fields are missing. The destructive-op cap does not apply since validation is explicitly present.

5 / 5

Progressive Disclosure

No bundle files exist and all ~90 lines of content (paths, pitfalls, tables) appropriately live inline in SKILL.md with clear section headers; tool schemas are correctly deferred to the tools themselves via ToolSearch. The duplicated quick-reference table is a minor organization gap keeping this below a 5.

4 / 5

Total

17

/

20

Passed

Description

92%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 what the skill does and when to trigger it with concrete user phrasings, and explicitly fences off neighboring skills with '不用于' boundaries. Only minor gap is a few missing natural synonyms for cancellation/rescheduling.

DimensionReasoningScore

Specificity

The description enumerates five concrete actions — '看今天/本周安排、查冲突、建会议、改时间、删日程' — covering query, conflict check, create, update, and delete on real calendar data, which is comprehensive coverage of the domain's operations.

5 / 5

Completeness

Explicitly answers both: what ('对真实日历数据做查询或增删改' with enumerated operations) and when ('当用户要对真实日历数据做查询或增删改时触发' plus quoted trigger phrases and explicit '不用于' exclusions).

5 / 5

Trigger Term Quality

Includes natural user phrasings ('我明天几点开会', '帮我约 xx', 'schedule a meeting') plus plain action verbs (建会议、改时间、删日程). A few natural synonyms like 取消/reschedule/预约 are missing, so it falls just short of comprehensive.

4 / 5

Distinctiveness Conflict Risk

The '不用于' clause explicitly disambiguates adjacent cases (casual time mentions → direct answer; recurring background jobs → schedule-ops-skill), giving this skill a clear niche with minimal conflict risk.

5 / 5

Total

19

/

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

itsablabla/openloaf-web

Path

apps/server/src/ai/builtin-skills/calendar-ops/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.