CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

lark-shared

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON.

Quality

88%

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

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.

An efficient, highly actionable rules-base skill body with a well-designed strong-trigger reference index and a properly gated high-risk approval workflow. Its weaknesses are minor: no complete worked command examples inline, core workflows delegated to references without inline checkpoints, and one orphaned bundle file.

Suggestions

Add one or two complete copy-paste command examples for the most common cases (e.g. `lark-cli auth login --as user` and a full `lark-cli auth qrcode --output qr.png` invocation) so guidance is fully executable without consulting references.

Either link `lark-wiki-token-routing.md` from the trigger index (or another appropriate section) or remove it from this skill's bundle so every references/ file is discoverable from SKILL.md.

Include a brief inline validation step for the auth/config workflows (e.g. verify identity with a status check after login) rather than relying entirely on the referenced files for checkpoint guidance.

DimensionReasoningScore

Conciseness

The ~40-line body is dense and prescriptive with zero padding: every rule carries non-obvious operational fact (the `ok == true` vs `code == 0` envelope trap, exit-code-10 approval gate, relative-path-only file arguments, QR-code pairing rule). It assumes Claude's competence and explains nothing the model already knows, matching the 'lean and efficient; every token earns its place' anchor — the one justification sentence (misjudging success via the legacy OpenAPI format) is a genuine gotcha, not filler.

5 / 5

Actionability

Guidance is concrete and executable: exact commands (`lark-cli auth qrcode` with `--output`/`--ascii`), exact flags (`--dry-run`, `--format json`, `--as user/bot`), exact envelope fields (`ok`, `risk: "high-risk-write"`, `hint`), and precise procedures (append the confirmation flag to the end of the original argv). It stops short of the 5 anchor because there are no complete copy-paste example invocations for the common cases (e.g. a full `auth login` or qrcode command line with arguments), leaving minor gaps; it is well above 3 since nothing is pseudocode or vague.

4 / 5

Workflow Clarity

The high-risk flow is an explicit, well-checkpointed sequence — exit 10 → stop → show `action`/`risk`/key params to the user → obtain explicit consent → append the hinted flag to the original argv → retry — with a genuine feedback (retry) loop and a hard validation gate (user confirmation). It sits at 4 rather than 5 because the body only sequences this one procedure; the other core workflows (login, identity diagnostics, config init) are deferred to references without inline validation steps, and the multi-step procedures that are present stop just short of full checklists.

4 / 5

Progressive Disclosure

Structure is strong: a clear overview split into general rules, security rules, and a MUST-read trigger-index table that maps trigger conditions to the correct reference file, specifies reading order, and deduplicates repeat reads; all five referenced files exist and are one level deep. Scored against the actual bundle, it lands at 4 rather than 5 because the references directory contains a sixth file, `lark-wiki-token-routing.md`, that is not navigable from SKILL.md — a minor organization gap consistent with the 4 anchor ('references mostly clear; minor organization gaps').

4 / 5

Total

17

/

20

Passed

Description

92%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 description: highly specific, third-person, with an explicit 'Use for' trigger clause and concrete command/flag names covering its auth/identity niche comprehensively. The only improvement space is broader synonym coverage of natural user phrasings.

DimensionReasoningScore

Specificity

The description lists multiple concrete, specific items — "auth login/status/logout", "user vs bot identity", "business-domain permissions (--domain, including all/docs/drive)", "missing scopes", "revoking authorization", "handling _notice JSON" — with actual flags and command names. Coverage of the lark-cli setup/auth domain is comprehensive, matching the score-5 anchor; it exceeds the 4 anchor ('several specific actions; minor gaps') because no meaningful task in its niche is left out.

5 / 5

Completeness

It explicitly answers 'when' with an opening "Use for lark-cli setup/auth tasks:" plus concrete trigger phrases (login/status/logout, missing scopes, revoking authorization, _notice JSON), and answers 'what' by enumerating the specific task areas. This matches the 5 anchor (both what and when explicit with concrete triggers) and clearly exceeds the 4 anchor where the 'when' clause is present but could be more specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "auth login", "logout", "missing scopes", "revoking authorization", "identity", "_notice" are phrases a user working with lark-cli would plausibly say. It falls short of the 5 anchor ('comprehensive coverage including synonyms and file extensions') because common variations like "log in"/"sign in", "token", or "who am I" are absent, though this does not drop it to 3 since the terms present are specific and relevant rather than missing common variations wholesale.

4 / 5

Distinctiveness Conflict Risk

The niche is clear and narrow — lark-cli setup/auth, identity, scopes, and notice handling — with distinct trigger terms unlikely to fire for unrelated skills. It sits at the 5 anchor ('clear niche with distinct triggers; minimal conflict risk'); the only conceivable overlap is with sibling lark-* skills, but those share this base by design and the enumerated triggers (auth, scopes, _notice) are uniquely routed here.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

larksuite/cli

Path

skills/lark-shared/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.