CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

external-resource-context

Records where resources outside the repository live (design source, design system, API schema, IaC source, secret store) and how design, implementation, and verification reach them. Use when work depends on an external resource, or when the user mentions design source, design system, API schema, IaC source, secret store, or canonical source.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

A well-crafted, token-efficient skill body: it defines a clear two-tier storage model, a single-source-of-truth rule, a sequenced consumption protocol with fallback behavior, and delegates detail to real, purpose-labeled reference files. The only notable gaps are the absence of an inline worked example of a completed record and a couple of implicit validation points in the workflow.

DimensionReasoningScore

Conciseness

The ~50-line body is lean and dense: a two-tier storage table, a single-source-of-truth rule, a numbered protocol, and exact output conventions, with every token carrying project-specific rules Claude could not infer. There is no padding and no explanation of concepts Claude already knows, matching the score-5 anchor.

5 / 5

Actionability

The guidance is concrete and executable: exact paths ('docs/project-context/external-resources.md'), fixed heading text 'External Resources Used' with per-document heading levels (h2 in UI Spec, h3 in Design Doc), a numbered reference protocol, and copy-paste templates delegated to references/template.md. It sits just below the score-5 anchor because no worked example of a completed record appears in the body itself — the example is delegated to the reference file.

4 / 5

Workflow Clarity

The Reference Protocol is a clearly sequenced three-step process with an explicit failure checkpoint ('When the file is absent or the resource is unreachable, continue from governing and repository evidence. Each consumer records the limitation in its applicable output'), and the capture workflow in references/hearing.md adds correction and fallback behavior. This is not a destructive or batch skill, so no cap applies; minor validation gaps (e.g., no explicit re-check after an environment change) keep it at score 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-sectioned overview with six references, each labeled with its purpose ('Decision-specific capture and storage', 'Frontend domain axes', 'Project-tier and feature-tier structure templates'), all of which exist and contain the promised material. References are one level deep with no further nesting, matching the score-5 anchor of a clear overview with well-signaled, appropriately split content.

5 / 5

Total

18

/

20

Passed

Description

83%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: third-person, concise, with a clear 'what' and an explicit, well-enumerated 'Use when...' clause. Its main limitations are a single core action verb rather than multiple distinct capabilities, and trigger terms that use abstract category names where concrete synonyms (specific tools or formats) would strengthen natural triggering.

DimensionReasoningScore

Specificity

The description names one core concrete action ('Records where resources outside the repository live ... and how design, implementation, and verification reach them') with a comprehensive enumeration of specific resource types (design source, design system, API schema, IaC source, secret store). It falls short of the score-5 anchor, which requires multiple distinct actions (e.g., extract, fill, merge, convert), but goes well beyond the score-3 anchor's limited 1-2 action coverage.

4 / 5

Completeness

It explicitly answers both 'what' (records where external resources live and how design, implementation, and verification reach them) and 'when' ('Use when work depends on an external resource, or when the user mentions design source, design system, API schema, IaC source, secret store, or canonical source') with concrete trigger phrases, matching the score-5 anchor. It clearly exceeds score 4, whose 'when' clause is less explicitly enumerated.

5 / 5

Trigger Term Quality

Trigger terms like 'design source', 'design system', 'API schema', 'IaC source', 'secret store', and 'canonical source' are natural phrases users in this domain would say, giving good keyword coverage. A few natural terms are missing — notably concrete tool or format synonyms (e.g., Figma, OpenAPI, Terraform) a user might mention instead of the abstract category names.

4 / 5

Distinctiveness Conflict Risk

The niche — recording access methods for external resources — is distinct, and the specific trigger terms (secret store, IaC source, API schema) reduce confusion risk. However, the broad trigger 'work depends on an external resource' leaves minor overlap risk with closely related design, frontend, or API-contract skills, keeping it below the minimal-conflict score-5 anchor.

4 / 5

Total

17

/

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

shinpr/claude-code-workflows

Path

dev-skills/skills/external-resource-context/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.