CtrlK
BlogDocsLog inGet started
Tessl Logo

external-research

Use when the task involves an external library or package and current API docs are needed before writing code.

58

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-code/skills/external-research/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-structured and highly actionable with executable commands, a concrete response format, and clear recovery guidance. Its main weakness is redundancy, where the worked example and the Remember section repeat the process rather than adding new information.

Suggestions

Replace the duplicate "Example: Using Drizzle ORM" walkthrough with a single condensed trace that shows only the command and response, avoiding a re-listing of all five steps.

Trim the "Remember" section to points not already stated verbatim in the Process and Cache sections, or fold it into a one-line summary.

Remove or compress the explanatory framing about training data being outdated where it repeats concepts Claude already knows.

DimensionReasoningScore

Conciseness

Most of the body is efficient and actionable, but the "Example: Using Drizzle ORM" section re-walks the same five steps already covered in "The Process", and "Remember" restates points made earlier, so it could be tightened.

2 / 3

Actionability

Concrete executable commands ("/external-scout drizzle schemas", "Read: .tmp/external-context/drizzle/schemas.md"), a full JSON response example, a cache tree, and specific fallback steps make the guidance copy-paste ready.

3 / 3

Workflow Clarity

A clear five-step sequence is paired with a check-response step (fresh/stale), a verification step ("Verify API signatures are correct"), and an Error Handling section providing feedback loops for recovery.

3 / 3

Progressive Disclosure

The skill is self-contained with no bundle files, and the body is organized into well-signaled sections (Overview, Process, Cache Location, Error Handling) with no nested references, so navigation is easy.

3 / 3

Total

11

/

12

Passed

Description

50%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a strong, explicit trigger clause but functions almost entirely as a "when" statement, leaving the skill's actual capability unstated. It is concise and third-person, yet reads as a condition rather than a capability statement.

Suggestions

Lead with a concrete capability verb before the trigger, e.g. "Fetches and caches current API documentation for external libraries or packages. Use when ...".

Expand trigger-term coverage with natural variations users say (framework names, "fetch docs", "look up the API", "get current version").

Make the "what" explicit (fetch, cache, and load current docs) so both halves of what/when are clearly answered.

DimensionReasoningScore

Specificity

It concretely scopes the domain ("external library or package", "current API docs ... before writing code") but names no concrete actions the skill performs, so it sits above the vague anchor-1 example yet below the multi-action anchor-3 example.

2 / 3

Completeness

The explicit "Use when ..." clause clearly answers when, but what the skill does (fetch and cache documentation) is only implied, so only one half of the what/when pair is explicit.

2 / 3

Trigger Term Quality

Terms like "external library", "package", "current API docs", and "writing code" are natural, but coverage lacks common variations (e.g. framework names, "fetch docs", "look up API"), matching the "some relevant keywords but missing variations" anchor.

2 / 3

Distinctiveness Conflict Risk

The "current API docs needed" niche is fairly specific, but "external library or package ... before writing code" is broad enough to overlap with general library-usage and coding skills, so it is not yet a clearly distinct trigger.

2 / 3

Total

8

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
darrenhinde/OpenAgentsControl
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.