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

83%

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

75%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 instruction-only skill body: lean, concrete paths and fixed heading conventions, a clear consumer protocol with explicit fallback handling, and a genuine overview-plus-references architecture. The recurring rule repetition across sections, the abstract capture section, and the tersely-labeled domain reference files keep it just below the top anchors.

Suggestions

Deduplicate the "project tier owns environment facts / preserve existing labels" rule — state it once (Single Source of Truth section) and drop its restatement in Output Format, letting template.md carry the operational reminder.

Replace the opaque "domain axes" labels in the References section with when-to-use cues (e.g., "frontend.md — cues for locating design-system and visual-verification facts") so a reader knows when to load each file without opening hearing.md first.

Add one compact inline example of a project-tier entry (label, location, access method) in the Output Format section so the common case is executable without immediately jumping to template.md.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no general-concept padding, and dense tables replace prose. It falls short of the 5 anchor because the project-tier-owns-environment-facts / preserve-existing-labels rule is stated in the Single Source of Truth section, restated in Output Format ("Preserve existing labels referenced by consumers"), and repeated again in template.md — trimmable repetition across sections.

4 / 5

Actionability

Concrete and executable for an instruction-only skill: exact file path (docs/project-context/external-resources.md), fixed heading text ("External Resources Used"), a numbered 3-step reference protocol, and a referenced template defining the exact record/table format. The "Capturing and Updating Records" section is comparatively abstract ("Reuse supplied access details and repository records, verify them within current authority") and fully defers execution detail, keeping it below fully-executable.

4 / 5

Workflow Clarity

The Reference Protocol is a clear 3-step sequence with an explicit failure fallback ("When the file is absent or the resource is unreachable, continue from governing and repository evidence. Each consumer records the limitation"), and staleness correction is delegated to hearing.md. Minor validation gaps remain in the body itself — no verify-after-write checkpoint for newly recorded entries, and the capture loop lives in a reference file rather than the main workflow.

4 / 5

Progressive Disclosure

Verified against the actual bundle: all 6 referenced files exist (hearing.md, template.md, frontend.md, backend.md, api.md, infra.md), the body is a lean overview with point-of-use references plus a References section, and the detailed formats are correctly split into template.md/hearing.md. Minor gaps: the References section descriptions ("Frontend domain axes", "API contract domain axes") are opaque about when to load each file, and hearing.md adds a second hop to the domain files even though they are also listed one level deep in SKILL.md.

4 / 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: third person, explicit and specific about what is recorded, with a concrete "Use when..." trigger clause enumerating the resource types it covers. The main residual weaknesses are minor trigger-term gaps (missing common synonyms like OpenAPI, proto, GraphQL, Terraform) and slight overlap risk on generic terms such as "design system".

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 two concrete recording actions plus an enumerated list of concrete resource types. It falls short of the 5 anchor because it does not list several distinct actions (only record-locations and record-access), but the specific enumeration puts it noticeably above the 1-2-action level of the 3 anchor.

4 / 5

Completeness

It explicitly answers 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 design source, design system, API schema, IaC source, secret store, or canonical source") with concrete trigger phrases, exactly matching the 5 anchor.

5 / 5

Trigger Term Quality

"external resource", "design source", "design system", "API schema", "IaC source", "secret store", and "canonical source" are natural terms a user would plausibly say when needing this skill. A few natural variations are missing — the body itself mentions OpenAPI / proto / GraphQL SDL and equivalents like Terraform or component library — so it is good but not comprehensive, matching the 4 anchor.

4 / 5

Distinctiveness Conflict Risk

The niche (recording locations and access methods of resources outside the repository) is clear and its triggers are largely distinctive (secret store, IaC source, canonical source). However, "design system" and "API schema" are terms other frontend/API skills also trigger on, giving minor overlap risk with closely related skills — the 4 anchor rather than 5.

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