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

82%

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

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

SKILL.md
Quality
Evals
Security

Quality

Content

71%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, reference-backed body with a clear two-tier storage model, a numbered consumption protocol with a failure branch, and clean one-level progressive disclosure into six real reference files. The main weakness is redundancy — the two-tier rule and access-method details are restated across three sections — plus some abstract policy phrasing where concrete checks would be more actionable.

Suggestions

Merge the 'Single Source of Truth Rule' and 'Output Format' sections into the Storage Locations table area: both largely restate what the table already says, and the heading-level and label-preservation rules can be one short list.

State the access-method enumeration (URL, MCP name, file path, command) once — in the Storage Locations table — and have the Reference Protocol step 3 simply say 'use the access method declared in the project tier'.

Replace abstract policy phrases like 'verify them within current authority' and 'continue from governing and repository evidence' with a concrete example of one verification check and one fallback action, so downstream consumers know exactly what to do.

DimensionReasoningScore

Conciseness

The body is compact and free of explanations of concepts Claude already knows, but the two-tier split is stated three times (the Storage Locations table, the "Single Source of Truth Rule" section, and the "Output Format" section), and access-method enumerations ("URL, MCP name, file path, command") repeat across the table and the Reference Protocol. This matches the 3 anchor (mostly efficient but could be tightened) rather than the 4 anchor's "minor instances".

3 / 5

Actionability

Guidance is largely concrete and executable: exact paths (`docs/project-context/external-resources.md`), a fixed heading text ("External Resources Used"), a numbered reference protocol, and templates in `references/template.md` with literal markdown. Abstract policy phrasing such as "verify them within current authority" and "continue from governing and repository evidence" lacks concrete checks or examples, holding it below the fully executable 5 anchor.

4 / 5

Workflow Clarity

The Reference Protocol is a clear 1-2-3 sequence with an explicit failure branch ("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 capture/update flow is delegated to hearing.md's stepwise process. The update-on-environment-change path and the split between capturing and consuming could be more sharply checkpointed, so it sits at 4 rather than 5.

4 / 5

Progressive Disclosure

The body is a well-organized ~45-line overview and every detail file is a real, one-hop reference, each annotated with its purpose ("Decision-specific capture and storage", "Frontend domain axes", etc.). Although hearing.md also links to the domain-cue files, those files are all directly listed in SKILL.md's References section, so no content is buried two levels deep — this matches the 5 anchor (clear overview, well-signaled one-level references, appropriate split).

5 / 5

Total

16

/

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: it explicitly states what the skill does and when to use it, with a concrete enumeration of covered resource types and natural trigger terms. The main gaps are missing common synonyms and tool-specific names (Figma, OpenAPI, Terraform) and the slightly broad first trigger clause.

DimensionReasoningScore

Specificity

The description names the domain ("resources outside the repository") with a concrete enumeration of five resource types ("design source, design system, API schema, IaC source, secret store") and states the concrete actions of recording locations and access paths. It falls below the 5 anchor because the action set is essentially one capability (recording) rather than multiple distinct actions.

4 / 5

Completeness

Both halves are explicit: the "what" is "Records where resources outside the repository live ... and how design, implementation, and verification reach them", and the "when" is a concrete "Use when ..." clause listing specific trigger phrases. This matches the 5 anchor (clear what and when with concrete triggers); the 4 anchor applies only when the 'when' is weakly specified, which is not the case here.

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" covers the natural domain vocabulary well. It misses common synonyms and tool names a user might actually say (e.g., Figma, OpenAPI spec, Terraform, design tokens, source of truth), keeping it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (recording external resource access points in a fixed project location) is distinct, and triggers like "IaC source" and "secret store" are unlikely to fire the wrong skill. The broad opening trigger "work depends on an external resource" leaves minor overlap risk with general context/docs skills, keeping it just below the 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-workflows-fullstack/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.