update-user-profile

Update user profile information when user shares preferences, habits, or work details. When you need to save user preferences, remember user's work domain, or provide personalized service.

Quality

81%

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

Quality

Content

92%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 clean, well-structured single-purpose skill body that is concise and clearly organized. The only minor gap is the lack of value examples or formats for the supported keys.

Suggestions

Add brief value examples or accepted formats for keys where the expected value is non-obvious (e.g., timezone, work_hours, detail_level) to close the small actionability gap.

Dimension	Reasoning	Score
Conciseness	The body is lean and efficient with a one-line description, a tight parameters table, and a flat supported-keys list; every token earns its place and no concepts Claude already knows are over-explained.	5 / 5
Actionability	The parameters table and explicit list of supported keys give concrete, actionable guidance for filling the tool call, but value formats or examples for each key are absent, leaving minor gaps.	4 / 5
Workflow Clarity	This is a simple single-purpose skill whose single action (call update_user_profile with a key/value pair) is unambiguous, satisfying the simple-skill exception with no destructive or batch operations requiring validation.	5 / 5
Progressive Disclosure	Under 50 lines with no need for external references, the content is well-organized into clear sections (Parameters, Supported Keys, Related Skills) with appropriately signaled cross-references to related skills.	5 / 5
	Total	19 / 20 Passed

Description

70%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 solid description that clearly states what the skill does and when to use it with natural trigger phrases. The main weakness is a somewhat generic 'what' statement and minor overlap risk from the broad 'personalized service' phrasing.

Suggestions

Make the 'what' more concrete by listing a few specific profile fields the skill handles (e.g., work domain, preferred language, timezone) rather than the generic 'Update user profile information'.

Consider narrowing or removing 'provide personalized service' to reduce overlap risk with other skills.

Dimension	Reasoning	Score
Specificity	The description names the domain ('Update user profile information') and 1-2 concrete actions ('save user preferences', 'remember user's work domain') but is not comprehensive in listing specific capabilities.	3 / 5
Completeness	It explicitly answers both what ('Update user profile information') and when ('when user shares preferences, habits, or work details'), with concrete trigger phrases, but the 'what' is somewhat generic and could be more specific.	4 / 5
Trigger Term Quality	It includes natural phrases users would actually say ('shares preferences, habits, or work details', 'save user preferences') with good keyword coverage, though a few common synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	Profile/preference saving is a mostly distinct niche with minimal conflict risk, though 'provide personalized service' is broad enough to risk minor overlap with other skills.	4 / 5
	Total	15 / 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: openakita/openakita
Path: skills/system/update-user-profile/SKILL.md
Commit: 3226e4a

Reviewed: 4 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.