CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

user-info

Use when current user identity, contact details, organization, subscription, or available points are needed.

Quality

76%

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 ./backend/super-magic/agents/skills/user-info/SKILL.md
SKILL.md
Quality
Evals
Security

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.

The body is an exemplary lean operational skill: executable code, explicit status-handling and consent rules, and a single well-signaled reference file for deep schema details. The only room for improvement is tightening a few cryptic caveat sentences, which keeps it just short of maximal token efficiency.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious operational semantics (snapshot freshness, section status codes, consent gating) and carries no filler or explanations of concepts Claude already knows, so it sits above 'mostly efficient'. It falls short of 5 only due to minor trimming opportunities — e.g. 'Agent identity and the name displayed to users are separate from this account' is cryptic and some caution sentences in the third-party-ID paragraph could be consolidated.

4 / 5

Actionability

Guidance is fully executable: two copy-paste-ready snippets (`tool.call("get_user_info", {})` and the consent-gated `include_sensitive_fields=["phone"]` call), concrete parameter names, and an enumerated status list (`available`/`unsupported`/`unavailable`/`none`) each with explicit behavioral instructions. The common cases — plain lookup, sensitive-field consent, and per-section failure handling — are all covered, matching the top anchor.

5 / 5

Workflow Clarity

As a simple read-only retrieval skill, the single action is unambiguous: prefer the snapshot, call `get_user_info` when freshness is needed, act per-section status, and gate the phone field on explicit consent. Failure paths are addressed ('If the base query fails, read `result.content` and decide whether to retry or continue independent work'), and there are no destructive or batch operations requiring validation checkpoints.

5 / 5

Progressive Disclosure

The body is a lean overview with well-organized sections and exactly one one-level-deep reference, clearly signaled with a conditional trigger: 'See [data schema](references/data-schema.md) only when structured fields are needed for tool-to-tool coordination' — and that file exists in the bundle (references/data-schema.md) and is self-contained, referencing no further files.

5 / 5

Total

19

/

20

Passed

Description

47%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 is a well-scoped, explicit trigger clause with a clearly identified domain, but it is missing the 'what' half entirely: it never states what the skill does (retrieve the authenticated user's profile via `get_user_info`). Adding a concrete action statement and common synonyms like "profile" or "account" would lift both completeness and trigger coverage.

Suggestions

Add a 'what' clause before the 'Use when' clause, e.g. 'Retrieves the current user's profile (identity, contact details, organization, subscription, points) via the get_user_info tool.'

Include natural synonyms users would actually say — 'profile', 'account', 'balance' or 'quota' — in the trigger list alongside the existing terms.

Anchor trigger wording to the concrete capability so the description stands alone, e.g. '...needed' → '...needed; calls get_user_info for a fresh snapshot'.

DimensionReasoningScore

Specificity

The description names the domain concretely ("current user identity, contact details, organization, subscription, or available points") but states no actions at all — nothing about what the skill actually does (e.g., calling `get_user_info` to fetch the account profile). This matches the anchor 'Names the domain but actions are minimal or generic' rather than score 1, since the domain facets are specific rather than purely abstract, and not score 3, which requires 1-2 concrete actions.

2 / 5

Completeness

Only the 'when' is present without any 'what': the description is entirely a "Use when... are needed" trigger clause, structurally identical to the score-2 anchor example 'Use when working with documents', and never states what the skill does. It cannot be 3 because that anchor requires a clear 'what'; it cannot be 1 because the 'when' is explicit and multi-faceted rather than extremely vague.

2 / 5

Trigger Term Quality

Natural terms users would say are present — "user identity", "contact details", "organization", "subscription", "available points" — giving good keyword coverage across the domain. Score 5 requires comprehensive synonym coverage; common variations like "profile", "account", "balance", or "quota" are missing, so it fits 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

The trigger set (session account identity, subscription, points) carves a clear niche that is mostly distinct from other skills. Minor overlap risk remains — "contact details" could collide with a contacts/CRM skill and "organization" with org-management skills — so it fits 'mostly distinct; minor overlap risk' rather than score 5's 'minimal conflict risk'.

4 / 5

Total

12

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dtyq/magic

Path

backend/super-magic/agents/skills/user-info/SKILL.md

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.