CtrlK
BlogDocsLog inGet started
Tessl Logo

gourmet-organizer

Organize tasting menus, menu photos, and visit notes into the right gourmet note. Use when the user shares a restaurant menu, wants a tasting write-up, or asks to merge a new visit into Notes/Gourmet.md without overwriting earlier visits.

59

Quality

67%

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 ./.codex/skills/gourmet-organizer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise and well-structured with a clear simple workflow and concrete command examples, but actionability is held back because the referenced main.py script is not present in any bundle. Shipping the referenced script would make the commands truly executable.

Suggestions

Provide the referenced main.py in a scripts/ bundle so the example commands are actually executable end-to-end.

Fix the incomplete syntax in 使用步骤 (steps 1 and 2 are missing a closing parenthesis and backtick/quote) so commands are copy-paste correct.

Clarify what the script outputs (step 3 "脚本将整理美食笔记") — e.g. note that it appends to Gourmet.md, which is referenced but not bundled.

DimensionReasoningScore

Conciseness

The body is lean with short, well-scoped sections (适用场景, 功能特点, 使用步骤, 示例) and no padding or explanation of concepts Claude already knows, matching the 'lean and efficient; every token earns its place' anchor.

3 / 3

Actionability

Concrete copy-paste commands are given ("python main.py \"...\"", "python main.py --file menu.txt"), but the referenced main.py is absent from the bundle, so the guidance is incomplete with a key missing detail — matching level 2 rather than fully executable level 3.

2 / 3

Workflow Clarity

The 使用步骤 section gives a clear 3-step sequence (prepare content → run script → script organizes notes) for a simple, non-destructive single task, which the simple_skills note allows to score 3 when unambiguous.

3 / 3

Progressive Disclosure

The skill is under 50 lines with no need for external references and is organized into clear sections, so per the under-50-lines guideline progressive disclosure scores 3 on well-organized structure alone.

3 / 3

Total

11

/

12

Passed

Description

50%

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 identifies a clear domain and a few actions but is terse and omits any explicit 'when to use' trigger, leaving it at the mid-level across all dimensions. Adding a 'Use when...' clause with more concrete trigger terms would lift completeness and trigger_term_quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when organizing food/tasting notes, reviewing menus, or the user mentions 美食/品鉴 experiences.'

Replace terse verbs with concrete actions, e.g. 'Organizes gourmet notes into Gourmet.md, analyzes and reviews menus, and weaves in the user's tasting experiences.'

Broaden trigger terms with common variations (美食笔记, 菜单品鉴, 美食记录, 美食日记) to improve natural keyword coverage.

DimensionReasoningScore

Specificity

Names the gourmet domain and a couple of actions ("整理美食笔记", "品鉴菜单") but they are terse and not comprehensive, matching the 'names domain and some actions' anchor rather than the multi-action level 3.

2 / 3

Completeness

It states what the skill does but has no 'Use when...' clause or equivalent trigger guidance, so per the judging guidelines completeness is capped at 2 (has what, when is only implied).

2 / 3

Trigger Term Quality

Contains some natural terms a user might say ("美食笔记", "品鉴菜单", "美食品鉴经历") but coverage is thin and lacks common variations, fitting 'some relevant keywords but missing common variations' rather than level 3's broad coverage.

2 / 3

Distinctiveness Conflict Risk

The gourmet-notes niche is somewhat specific, but the weak trigger guidance means it could still overlap with general note-taking skills, matching 'somewhat specific but could still overlap'.

2 / 3

Total

8

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
huangruiteng/CS-Notes
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.