id-photo-tool

Replace an ID photo background color (blue/white/red) and/or add a configurable text watermark when you need compliant ID-photo variants from local JPG/PNG files.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./scientific-skills/Other/id-photo-tool/SKILL.md

Quality

Content

68%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 with executable examples and a real backing script, weakened by duplicated content across sections and an absence of validation/verification steps for the batch operations it advertises.

Suggestions

Deduplicate the supported colors, watermark positions, and no-overwrite guarantee so they appear once (e.g., keep them in Key Features and reference them from Implementation Details) to improve conciseness.

Add an explicit verification step for batch workflows, such as a command or check to confirm the output image is valid and the background was actually replaced before declaring success, to lift workflow clarity above the batch cap.

Add a one-line pointer to scripts/id_photo_tool.py (e.g., 'Implementation lives in scripts/id_photo_tool.py') and move any remaining inline algorithm detail there to sharpen progressive disclosure.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of patronizing explanations, but Key Features and Implementation Details duplicate the supported color list (blue/white/red) and the five watermark positions, and the no-overwrite guarantee is restated in Security Notes, so it could be tightened.	3 / 5
Actionability	Provides copy-paste-ready, fully executable CLI commands covering the common cases (change-bg for JPG and PNG, add-watermark) and the referenced script file actually exists, matching the top anchor.	5 / 5
Workflow Clarity	Although each operation is a single clear command, the skill explicitly markets batch generation ('batch-generate multiple variants') yet describes no validation or verification step, so the batch-operation cap applies and it cannot exceed 3.	3 / 5
Progressive Disclosure	Well-organized into clear sections with implementation code living one level deep in scripts/id_photo_tool.py, but there is no explicit pointer to that script and some details are duplicated inline, leaving minor organization gaps.	4 / 5
	Total	15 / 20 Passed

Description

87%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, third-person description that concisely states concrete capabilities and an explicit use-trigger, with only minor gaps in action breadth and synonym coverage. No first/second-person voice or vague fluff.

Dimension	Reasoning	Score
Specificity	Names two concrete actions ('Replace an ID photo background color', 'add a configurable text watermark') with rich parameter detail (blue/white/red, configurable opacity/font/color, JPG/PNG), sitting above the 1-2-action anchor 3 but below the comprehensive several-action anchor 5.	4 / 5
Completeness	Explicitly answers both what (replace background / add watermark) and when ('when you need compliant ID-photo variants from local JPG/PNG files') with a concrete trigger phrase, matching the top anchor.	5 / 5
Trigger Term Quality	Includes natural terms a user would say ('ID photo', 'background color', 'watermark', 'JPG/PNG') but misses common synonyms like 'passport photo', so good but not comprehensive coverage.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (ID-photo background replacement and watermarking) with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: aipoch/medical-research-skills
Path: scientific-skills/Other/id-photo-tool/SKILL.md
Commit: 63c61d3

Reviewed: 1 hour 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.