Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, well-structured policy skill: every token carries platform-specific rules Claude could not infer, anchored by a copy-paste-ready registration example and precise API names for credential resolution. The main gaps are the lack of concrete API guidance for the OAuth/connection-catalog paths and the absence of an end-to-end verification step in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: it explains no general concepts (no OAuth primer, no library comparisons) and every sentence carries platform-specific policy Claude could not infer ("registerRequiredSecret", "resolveSecretDetailed()", tenancy restrictions on env keys). The dense env-key exception paragraph states four distinct rules (fallback permission, precedence, tenancy restriction, exception boundary) rather than padding, matching anchor 5 better than anchor 4, which would require trimmable over-explanation. | 5 / 5 |
Actionability | The registration example is complete, copy-paste-ready TypeScript, and the resolve path names exact APIs ("use `resolveSecretDetailed()` from `@agent-native/core/server`", "Check `lookupFailed` before checking `value`"). However, the connection-catalog and OAuth paths provide no concrete API calls ("request the app grant and resolve its vault-backed credential reference through the workspace-connection API" names no function), and the resolve flow has no code example — minor gaps that fit anchor 4 rather than anchor 5's coverage of the common cases. | 4 / 5 |
Workflow Clarity | "Choose the credential source" is a clear numbered 1-4 decision procedure followed by a register-then-resolve flow, with explicit error-handling checkpoints ("make a store failure retryable", "do not turn a failed lookup into a setup prompt", "redact provider responses before returning an error"). No destructive or batch cap applies. It fits anchor 4 rather than 5 because there is no end-to-end verification step and the register→resolve ordering is implied by section order rather than stated as a sequence. | 4 / 5 |
Progressive Disclosure | This is a self-contained single-file skill with no bundle files, and nothing inlined here belongs in a separate file — all ~70 lines are core policy for this one task. Sections are cleanly headed (Rule / Choose the credential source / Register / Resolve / Related skills), references are nonexistent rather than buried or nested, and the "Related skills" section aids cross-navigation. There are no organizational gaps that would justify dropping to anchor 4. | 5 / 5 |
Total | 18 / 20 Passed |