CtrlK
BlogDocsLog inGet started
Tessl Logo

device-magic

Device Magic integration. Manage Forms. Use when the user wants to interact with Device Magic data.

64

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/device-magic/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 a strong, executable CLI integration guide with concrete commands at every step and real validation checkpoints for the connection lifecycle. Its only notable gaps are a padded product-description intro and a 'Step 2' reference with no matching label.

DimensionReasoningScore

Conciseness

The body is mostly concrete commands and a tight overview list, but opens with a paragraph explaining what Device Magic is for business users ("mobile forms automation platform... field service teams, inspectors, and auditors"), which is over-explanation Claude does not need. It is not a 5 because of that padded intro and a few explanatory asides, and not a 3 because the bulk is efficient command-focused content.

4 / 5

Actionability

It provides copy-paste-ready commands for every stage (install, login, connection ensure, action list, action run, request) plus a full popular-actions table with keys and descriptions. It is not a 4 because the examples cover the common cases completely with concrete flags and JSON-input patterns.

5 / 5

Workflow Clarity

The sequence (install -> authenticate -> connect -> poll until READY -> search -> run) is clear with explicit state-checkpoint polling (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a re-poll feedback loop. It is not a 5 because 'skip to Step 2' references a Step 2 that is never labeled, creating a minor navigation gap, and not a 3 because validation checkpoints are present and explicit.

4 / 5

Progressive Disclosure

No bundle files exist, so this scores on structure: the content is organized into clear headed sections (Overview, Working with Device Magic, Popular actions, Best practices) with no nested references. It is not a 5 because at ~165 lines the popular-actions table and proxy-flag reference are inlined where a separate reference file could live, and not a 3 because the sections are well-signaled and navigable rather than a wall of text.

4 / 5

Total

17

/

20

Passed

Description

73%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 short, third-person, and clearly scoped to a distinct product niche with an explicit 'Use when' trigger. Its main weakness is the thin 'what' clause, which lists only one generic action ("Manage Forms") instead of enumerating concrete capabilities.

Suggestions

Expand the 'what' clause into 2-3 concrete capabilities, e.g. 'List and retrieve forms, submissions, destinations, devices, and groups; create or update forms and resources.' to lift specificity toward 5.

Add natural synonyms and a file/format cue to the trigger phrase, e.g. 'Use when the user wants to manage Device Magic forms, submissions, or field-data collection.'

Keep the explicit 'Use when...' clause (it correctly drives completeness) but pair it with the broader capability list so both 'what' and 'when' are concrete.

DimensionReasoningScore

Specificity

The description names the domain ("Device Magic integration") and one concrete action ("Manage Forms"), matching the anchor for naming a domain with 1-2 actions; it stops short of comprehensive coverage, and "Manage Forms" is somewhat generic. It is not a 2 because it does name a concrete entity (Forms) rather than only the domain, and not a 4 because it lists only one thin action with no enumeration of capabilities.

3 / 5

Completeness

It has both a 'what' ("Device Magic integration. Manage Forms.") and an explicit 'when' ("Use when the user wants to interact with Device Magic data"), satisfying the both-present anchor. It is not a 5 because the 'what' is thin and the 'when' is a single broad clause rather than concrete trigger phrases, and not a 3 because the 'when' is explicit rather than merely implied.

4 / 5

Trigger Term Quality

"Device Magic", "Forms", and "Device Magic data" give good natural-keyword coverage that a user would plausibly say, matching the good-coverage anchor. It is not a 5 because it omits synonyms and file extensions, and not a 3 because the product name plus a natural task term exceed the 'some relevant keywords' bar.

4 / 5

Distinctiveness Conflict Risk

"Device Magic" names a specific product niche with distinct triggers, giving minimal conflict risk with other skills. It is not a 4 because the product name alone scopes it tightly enough to avoid meaningful overlap with related document/form skills.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
membranedev/application-skills
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.