CtrlK
BlogDocsLog inGet started
Tessl Logo

agntcy-dir

Use this skill to interact with an AGNTCY Directory (DIR) instance. This is a bootstrap: it installs the complete agntcy-dir skill (setup, authoring, publishing, discovery, verification, sync, install workflows) from the AGNTCY Directory GitHub repository, then defers to it.

68

Quality

84%

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

90%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 tight, highly actionable bootstrap with copy-paste install scripts and an explicit verification checkpoint, plus clean signaling to the full remote skill. Adding an error-recovery step for failed verification would round out the workflow.

Suggestions

Add a feedback loop after the verify step: if any of the seven references/*.md files are missing, re-fetch just those files and re-verify before proceeding.

Surface the seven reference files (authoring, discovery, install, publishing, setup, sync, verification) in a short navigation list outside the code block so the structure is scannable without reading the script.

DimensionReasoningScore

Conciseness

The body is lean: a one-line purpose statement, a host table, copy-paste bash and PowerShell blocks, and brief rules — no padding and no explanation of concepts Claude already knows; every line earns its place.

5 / 5

Actionability

It provides fully executable, copy-paste-ready bash and PowerShell scripts with exact raw GitHub URLs, destination paths, and a loop over all seven reference files, covering the common Linux/macOS and Windows cases.

5 / 5

Workflow Clarity

The sequence (install -> verify -> reload -> follow installed skill) is clear with an explicit validation checkpoint ('destination must contain SKILL.md and all seven references/*.md files') and an overwrite confirmation, but there is no feedback loop describing what to do if verification fails.

4 / 5

Progressive Disclosure

The bootstrap is itself a concise overview that clearly signals the one-level-deep full skill in the repo's .skill/ folder (router SKILL.md plus seven references), with well-organized ## Install and ## After installing sections; minor gap is that the reference list lives only inside the code loop rather than a dedicated navigation block.

4 / 5

Total

18

/

20

Passed

Description

78%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 clear, third-person description that names a distinct niche and answers both what and when, with good keyword coverage for its specialized domain. It could sharpen the trigger scenarios and add a few natural synonyms to reach the top anchor.

Suggestions

Expand the 'when' clause with concrete user scenarios, e.g. 'Use when the user wants to author, publish, discover, verify, or sync agents in the AGNTCY Directory'.

Add natural synonyms users might say ('agent registry', 'publish agents', 'DIR') alongside 'AGNTCY Directory (DIR) instance'.

DimensionReasoningScore

Specificity

It names the domain and lists several concrete sub-workflows ('setup, authoring, publishing, discovery, verification, sync, install workflows') plus the two concrete actions of the bootstrap itself ('installs the complete agntcy-dir skill ... then defers to it'), but the enumerated workflows describe what is installed rather than distinct actions this skill performs.

4 / 5

Completeness

Both 'what' (installs the full skill from the GitHub repo and defers to it) and 'when' ('Use this skill to interact with an AGNTCY Directory (DIR) instance') are present and explicit, but the 'when' could be more specific about the user scenarios that should trigger it.

4 / 5

Trigger Term Quality

It includes the natural niche terms 'AGNTCY Directory (DIR) instance' and the workflow keywords (authoring, publishing, discovery, etc.) that a user would plausibly say, though common synonyms like 'agents', 'agent registry', or 'publish agents' are missing.

4 / 5

Distinctiveness Conflict Risk

The 'AGNTCY Directory (DIR) instance' framing is a clear, narrow niche with distinct triggers and minimal overlap risk against other skills.

5 / 5

Total

17

/

20

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
agntcy/dir
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.