CtrlK
BlogDocsLog inGet started
Tessl Logo

local-tools

Access local system resources including Calendar on macOS and Windows. Use this skill when you need to manage user's schedule directly on their device.

56

Quality

64%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./SKILLs/local-tools/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

This is a highly actionable skill — complete executable commands, documented JSON output, error codes, and platform-specific troubleshooting that a model can follow directly. Its weaknesses are token efficiency and file structure: the body repeats platform and best-practice content across multiple sections and inlines ~200 lines of reference material (troubleshooting, technical details, known behaviors) that belong in separate reference files, especially given no references/ directory exists alongside the scripts.

Suggestions

Cut the redundant platform coverage to one section (merge the architecture diagram, Platform Support table, and Technical Details), and merge the two 'Best Practices' sections into one.

Move Troubleshooting, Known Behaviors, and Technical Details into references/ files (e.g. references/troubleshooting.md) with clearly signaled one-level-deep links from SKILL.md, trimming the body to commands, output format, and core patterns.

Add an explicit confirm-before-delete checkpoint (or a --dry-run/confirm note) to the delete workflow to close the last workflow-clarity gap for destructive operations.

DimensionReasoningScore

Conciseness

The ~470-line body is noticeably verbose: platform information is repeated four times (the architecture diagram, Platform Support table, Architecture list, and Technical Details), there are two separate 'Best Practices' sections, 'Common Patterns' restates the earlier command examples, and Technical Details explains implementation internals (JXA via osascript, BSD date flags, PowerShell [DateTime]::Parse) that Claude neither needs nor is even told to inspect. It is above 1 because the operational sections themselves (commands, output format, error codes) are information-dense rather than padded with concepts Claude already knows.

2 / 5

Actionability

Every operation (list, create, update, delete, search) has complete, copy-paste-ready bash commands with all flags shown, the script path construction is spelled out step-by-step with a worked example, and the JSON success/error response shapes plus an error-code table with recoverability flags give fully executable guidance. Specific examples cover the common cases (date ranges, calendar selection, notes/location, searching by keyword), matching the 'fully executable, copy-paste ready' anchor.

5 / 5

Workflow Clarity

Sequences are clear and checkpointed for the risky operations: 'Always Check Before Creating' (list before create), 'Search Before Updating/Deleting' (find the event ID first), an error-handling pattern that parses the response and branches, and Troubleshooting entries that pair each error with a concrete solution — a feedback loop. It falls short of 5 because there is no explicit confirm-before-delete step for the destructive delete operation and validation relies on the model reading JSON output rather than an explicit checkpoint instruction.

4 / 5

Progressive Disclosure

Scored against the actual bundle: both referenced scripts (scripts/calendar.sh, scripts/calendar.ps1) exist and their paths are clearly signaled with explicit path-construction instructions — good one-level-deep tool disclosure. However, the SKILL.md itself is monolithic: Troubleshooting, Known Behaviors, Technical Details, and the full Error Codes/JSON reference are all inlined (~470 lines) where they clearly belong in reference files, so structure exists but content that should be separate is inline.

3 / 5

Total

14

/

20

Passed

Description

65%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 has an explicit, well-formed 'Use when' trigger clause and good natural keywords (calendar, schedule), but the capability side is generic — it never states what operations are supported (view/create/update/delete events) or that structured JSON output is returned. It reads as a domain label with a trigger rather than a capability inventory, which keeps it in the middle of the range.

Suggestions

Enumerate the concrete operations in the description, e.g. 'View, create, update, delete, and search calendar events, returning structured JSON' — this would lift the specificity score.

Add natural trigger variations users actually say — 'meetings', 'events', 'appointments', 'my schedule today' — to the 'Use when' clause.

Drop the vague 'Access local system resources' opener and the second-person 'when you need to' phrasing in favor of third-person, calendar-specific language to reduce overlap risk with other local-device skills.

DimensionReasoningScore

Specificity

The description names the domain ("Calendar on macOS and Windows") but its actions are generic — "Access local system resources" and "manage user's schedule" — with no concrete operations (view, create, update, delete events) named, matching the 'names the domain but actions are minimal or generic' anchor. It does not reach 3 because no concrete action verb is ever specified; the mild second-person trigger phrasing ('when you need to manage') also works against the third-person voice the rubric rewards.

2 / 5

Completeness

Both parts are present: a what ("Access local system resources including Calendar on macOS and Windows") and an explicit when ("Use this skill when you need to manage user's schedule directly on their device"), so the missing-'Use when' cap at 3 does not apply. It falls short of 5 because the 'what' is vague (no operations listed) and the 'when' lacks concrete trigger phrases like 'show me my schedule' or 'create a meeting'.

4 / 5

Trigger Term Quality

It includes the two most natural user phrasings — "Calendar" and "manage user's schedule" — plus platform terms (macOS, Windows), giving good keyword coverage. It stays below 5 because common variations users actually say — "events", "meetings", "appointments", "my calendar today" — are missing, and "local system resources" is technical jargon rather than a natural trigger.

4 / 5

Distinctiveness Conflict Risk

"Calendar on macOS and Windows" and "manage user's schedule directly on their device" carve out a fairly clear local-calendar niche with distinct triggers. It is not 5 because 'local system resources' is broad and could overlap with other local-device or scheduling-related skills (e.g. email-based invitation tools), and no disambiguating contrast is drawn.

4 / 5

Total

14

/

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
netease-youdao/LobsterAI
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.