gift-evaluator

The PRIMARY tool for Spring Festival gift analysis and social interaction generation. Use this skill when users upload photos of gifts (alcohol, tea, supplements, etc.) to inquire about their value, authenticity, or how to respond socially. Integrates visual perception, market valuation, and HTML card generation.

Quality

75%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/gift-evaluator/SKILL.md

Quality

Discovery

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong description that clearly defines a unique skill niche. It specifies concrete actions (visual perception, market valuation, HTML card generation), provides natural trigger terms (gift photos, alcohol, tea, supplements, value, authenticity), and explicitly states when to use it. The description is well-structured and distinctive enough to avoid conflicts with other skills.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: gift analysis, social interaction generation, visual perception, market valuation, HTML card generation. Also provides concrete examples of gift types (alcohol, tea, supplements) and specific use cases (value, authenticity, social response).	3 / 3
Completeness	Clearly answers both what ('gift analysis and social interaction generation', 'visual perception, market valuation, and HTML card generation') and when ('when users upload photos of gifts to inquire about their value, authenticity, or how to respond socially').	3 / 3
Trigger Term Quality	Includes natural keywords users would say: 'photos of gifts', 'alcohol, tea, supplements', 'value', 'authenticity', 'Spring Festival gift'. These are terms a user would naturally use when uploading a gift photo and asking about it.	3 / 3
Distinctiveness Conflict Risk	Highly distinctive niche combining Spring Festival context, gift photo analysis, valuation, and social response generation. Very unlikely to conflict with other skills due to the specific cultural and functional domain.	3 / 3
	Total	12 / 12 Passed

Implementation

50%

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

The skill provides a creative and well-structured workflow for gift appraisal with clear phases, but suffers from vague tool references in early phases, lack of validation/error handling steps, and some unnecessary narrative framing. The HTML generation command is the strongest actionable element, while the perception and search phases need more concrete, executable guidance.

Suggestions

Specify exact tool names and invocation syntax for the vision analysis and search phases instead of generic references like 'Call the vision tool'.

Add validation checkpoints after each phase (e.g., 'If search returns no price data, estimate based on brand tier and note uncertainty').

Remove metaphorical labels ('The Eye', 'The Brain', 'The Mouth') and the introductory paragraph to save tokens—jump straight into the workflow.

Link to or provide documentation for html_tools.py so Claude knows what parameters are accepted and what errors to expect.

Dimension	Reasoning	Score
Conciseness	The skill includes some unnecessary framing (e.g., 'This skill transforms the assistant into...', metaphorical labels like 'The Eye', 'The Brain', 'The Mouth') and explanatory text that could be trimmed. However, most content is functional and relevant to the task.	2 / 3
Actionability	The skill provides a concrete CLI command for the HTML generation phase and specifies JSON formats, but the vision and search phases are vague ('Call the vision tool', 'use search tools') without specifying exact tool names or executable commands. The search command is shown as pseudocode rather than a real invocation.	2 / 3
Workflow Clarity	The four-phase workflow is clearly sequenced (Perception → Valuation → Structuring → Creation), but there are no validation checkpoints or error recovery steps. Given that this involves file generation and external tool calls, missing feedback loops (e.g., what if search returns no results, what if HTML generation fails) cap this at 2.	2 / 3
Progressive Disclosure	The content is reasonably structured with clear sections and phases, but everything is inline in a single file. The reference to 'html_tools.py' is made without linking to documentation for that tool. For a skill of this length (~80+ lines of substantive content), some content like the JSON format specifications or the detailed critique guidelines could be split into referenced files.	2 / 3
	Total	8 / 12 Passed

Validation

100%

Warnings & errors only

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

Validation — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: jjyaoao/HelloAgents
Commit: 07048a9

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.