CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

67

Quality

84%

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

The canonical home for this skill is external-resource-context in shinpr/claude-code-workflows

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-structured, efficient instruction skill with a clear two-tier storage model, a sequenced consumption protocol with fallback handling, and exemplary reference organization. Actionability and conciseness are solid but could reach the top anchors with an inline example entry and light trimming of redundant prose.

Suggestions

Inline one short example row of a project-tier entry (or a two-column feature-tier row) so the format is usable without opening references/template.md.

Trim the resource enumeration in the Purpose paragraph since the two-tier table and references already enumerate the domains, and tighten the duplicated template-format sentence.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence — no explanation of concepts Claude already knows, with the two-tier storage model compressed into a table. Two spots could be trimmed: the Purpose paragraph's resource list duplicates what the tier table and references already convey, and the sentence "Example feature-tier entry uses the table format defined in references/template.md..." restates the template reference awkwardly.

4 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: exact paths ("docs/project-context/external-resources.md"), fixed heading text ("External Resources Used"), and an explicit three-step reference protocol. It stops short of anchor 5 because no example project-tier or feature-tier entry appears inline — the reader must open references/template.md to see the actual format.

4 / 5

Workflow Clarity

The Reference Protocol is a clearly sequenced three-step process with an explicit fallback checkpoint ("When the file is absent or the resource is unreachable, continue from governing and repository evidence"). The capture/update workflow is delegated to references/hearing.md rather than summarized, which is appropriate but leaves the main workflow's checkpoints implicit in the parent body.

4 / 5

Progressive Disclosure

The ~50-line body is a clear overview with well-signaled, one-level-deep references: all six referenced files exist in references/ and each is listed with a one-line description of what it holds. Domain detail (hearing conditions, domain axes, templates) is appropriately split out with easy navigation.

5 / 5

Total

17

/

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 with explicit what-and-when structure and a well-defined niche around external-resource context. The main gaps are a slightly thin action vocabulary and missing common synonyms in the trigger list.

Suggestions

Add one or two more concrete capability verbs (e.g., "captures access methods" or "validates reachability") so the action list is as comprehensive as the resource enumeration.

Include natural synonyms and concrete artifact names in the trigger clause (e.g., OpenAPI spec, Terraform, design tokens) alongside the abstract terms to widen trigger coverage.

DimensionReasoningScore

Specificity

"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" names the domain with two concrete, specific actions and a comprehensive enumeration of resource types. It falls short of anchor 5, which expects multiple listed concrete actions rather than one recording action with a rich object list.

4 / 5

Completeness

The description explicitly answers both questions: what ("Records where resources outside the repository live ... and how design, implementation, and verification reach them") and when ("Use when work depends on an external resource, or when the user mentions ..."), with concrete trigger phrases. This matches anchor 5 directly.

5 / 5

Trigger Term Quality

"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" gives good keyword coverage with natural domain phrasing. Common synonyms and concrete tool terms (e.g., OpenAPI, Terraform, design tokens, Figma) are missing, keeping it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The enumerated triggers (secret store, IaC source, design source) establish a clear niche with minimal overlap. The general trigger "work depends on an external resource" is broad enough to overlap with API- or database-focused skills, so it does not fully meet anchor 5's minimal conflict risk.

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