CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

1password

1Password integration. Manage data, records, and automate workflows. Use when the user wants to interact with 1Password data.

Quality

65%

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 ./skills/1password/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 content is genuinely actionable — executable Membrane commands with a well-handled connection state machine — but it wastes tokens on a concept intro and filler, and its workflow numbering is incoherent (dangling "Step 2" references, an orphan "1b" section). Cleaning the structure and trimming known-concept padding would move it up a full level.

Suggestions

Fix the workflow numbering: define explicit "Step 1 / Step 2" sections (or renumber "1a/1b" to match) so the two "skip to Step 2" references resolve to a real target.

Delete the "1Password is a password manager..." intro paragraph and the "Use action names and parameters as needed." filler — Claude already knows what 1Password is.

Merge the redundant "Searching for actions" / "Popular actions" sections (both show the same `action list --intent` command) and add one worked 1Password example, e.g., `action run` retrieving an item from a vault, plus a value for the `--tenant` flag.

DimensionReasoningScore

Conciseness

The body is mostly tight, executable commands, but it opens with a "1Password is a password manager that securely stores passwords..." paragraph explaining a concept Claude already knows, plus filler like "Use action names and parameters as needed." and a redundant restatement of the action-discovery command under "Popular actions". Fits anchor 3 (mostly efficient, some unnecessary explanation); not 2 because padding is limited to a few spots, not 4 because those spots are clear violations.

3 / 5

Actionability

Concrete copy-paste commands cover install, login (including the headless `login complete <code>` path), connection ensure, polling, action list/run with JSON parameters, and proxy requests with a flags table. Fits anchor 4 (mostly executable, minor gaps); not 5 because `membrane login --tenant --clientName=<agentType>` shows an apparently valueless flag and no worked 1Password-specific action example (e.g., listing vault items) is given, not 3 because the guidance is genuinely executable rather than high-level hints.

4 / 5

Workflow Clarity

The connection flow has a good explicit state machine (READY / CLIENT_ACTION_REQUIRED / CONFIGURATION_ERROR with `--wait` polling and re-poll after user action), but "skip to Step 2" is referenced twice with no Step 2 existing, and a "#### 1b" section appears without a "1a" or numbered step structure — the stated sequence is partially incoherent. Fits anchor 3 (sequence present but with structural/checkpoint gaps); not 4 because the dangling step references break the sequence's coherence, not 2 because a mostly-followable install→auth→connect→act path with state checkpoints is present.

3 / 5

Progressive Disclosure

No bundle files exist, so everything lives in SKILL.md: headers do provide navigable structure, but detail that could live in reference files (the proxy flags table, the full clientAction branch taxonomy) is inlined, and organization is marred by a stray overview tree, a filler line, and broken step numbering. Fits anchor 3 (some structure, could be better organized, content that should be separate is inline); not 4 because the organization gaps are more than minor, not 2 because the body is not a monolithic wall of text.

3 / 5

Total

13

/

20

Passed

Description

57%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 has a clear explicit trigger clause and a distinct 1Password niche, but its capability statement is generic. Replacing "Manage data, records, and automate workflows" with concrete actions and natural terms (passwords, vaults, items, credentials) would lift it substantially.

Suggestions

List concrete capabilities instead of generic verbs — e.g., "Search and retrieve vault items, create and update passwords and secure notes, list vaults and tags".

Add natural trigger terms users would actually say: "passwords", "vaults", "credentials", "secure notes", not just "1Password data".

Drop the buzzword-ish "automate workflows" or ground it in what automation actually means here (chaining 1Password actions via Membrane).

DimensionReasoningScore

Specificity

"Manage data, records, and automate workflows" names the domain but uses generic verbs — no concrete actions like "search vault items" or "retrieve passwords". It sits between anchor 2 (minimal/generic actions) and anchor 3 (1-2 concrete actions); the verbs are too abstract to count as concrete, so it fits anchor 2.

2 / 5

Completeness

It explicitly answers "when" via "Use when the user wants to interact with 1Password data", and the "what" ("1Password integration. Manage data, records, and automate workflows") is present but generic. Fits anchor 4 (both present, one could be more specific); not 5 because the what lacks concrete capabilities, not 3 because the when clause is explicit rather than weakly implied.

4 / 5

Trigger Term Quality

"1Password" is the one strong natural keyword a user would say, but common variations — passwords, vaults, credentials, secure notes, items — are absent. This matches anchor 3 (some relevant keywords, missing variations); not 4 because coverage beyond the app name is thin, not 2 because the primary natural term is present and well-targeted.

3 / 5

Distinctiveness Conflict Risk

The 1Password scoping gives a clear niche with low wrong-skill trigger risk, but generic phrases like "Manage data, records, and automate workflows" create minor overlap with other automation/integration skills. Fits anchor 4 (mostly distinct, minor overlap risk); not 5 due to those generic verb phrases, not 3 because the explicit 1Password trigger is distinctly scoped.

4 / 5

Total

13

/

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.

Validation — 15 / 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

Path

skills/1password/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.