CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agntcy-dir

Use when the user asks to discover, browse, search, suggest, recommend, or install agents and agentic resources. Author, validate, or import OASF records; push, sign, and publish records; discover, search, browse, suggest, or recommend agents like MCP servers, A2A agents, or agent skills; claim and prove record ownership or identity (DNS, HTTPS, DID, SPIFFE, ANS); verify signatures, ownership claims, or security scans; list running agent workloads; configure node content policies and prune jobs; synchronize data between servers; or install/uninstall agents and agentic resources into coding agents like VS Code Copilot, Claude Code, or Cursor.

Quality

88%

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

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-architected router skill: navigation, preflight, platform adaptation, and safety rules are crisp and concrete, with detail correctly pushed into nine real, one-level-deep reference files. The remaining upside is tightening the platform/adaptivity tables and surfacing at least skeleton validation sequences inline.

Suggestions

Trim or move part of the bash→PowerShell idiom table and the per-host adaptivity table into setup.md/install.md, keeping only the rule ('emit for the host's shell') plus one or two examples inline.

Add a one-line inline skeleton of the common workflow shape (e.g. probe → context → read reference → run with -o json → confirm destructive ops) so the body itself carries the validation sequence without needing to open a reference.

Consider replacing a few example intents in the dispatch table with broader trigger classes (login/auth, setup/diagnostics) to shorten the table while preserving routing coverage.

DimensionReasoningScore

Conciseness

The body is an efficient router: it teaches only DIR-specific vocabulary ("Same bytes → same CID. Any change → new CID."), never concepts Claude already knows, and delegates detail to references. Minor instances could still be trimmed — e.g. the full bash→PowerShell translation table and the per-host adaptivity table carry setup/install detail that could partly live in setup.md or install.md — so it sits at 4 rather than the 'every token earns its place' 5 anchor.

4 / 5

Actionability

Concrete, executable guidance is present throughout: probe commands ("dirctl version", "command -v dirctl", "Get-Command dirctl", "dirctl context show"), explicit output conventions ("request -o json... -o raw for CIDs in shell pipelines"), ordered server-resolution precedence, and capability probing via "dirctl <cmd> --help" with documented fallbacks. It stops short of copy-paste-ready workflow commands because those are deliberately delegated to the reference files, matching the 4 anchor's 'concrete commands with minor gaps'.

4 / 5

Workflow Clarity

The routing workflow is a clear, sequenced preflight: probe dirctl, resolve server context in documented order, dispatch via the intent table, then apply universal conventions — with checkpoints for risky paths (destructive ops "always confirm with the user first", auth errors surfaced raw and escalated rather than retried). The destructive/batch cap does not apply since confirmation and error-recovery rules are present, but per-workflow validation steps (e.g. validate-before-push) live in the references rather than here, keeping it at 4.

4 / 5

Progressive Disclosure

The body is a clean overview with a dispatch table that links each user intent to one of nine real reference files, all of which exist in the bundle and are one level deep (reference files cross-link only to siblings, not to further-nested files). Universal conventions and vocabulary are appropriately inline; this matches the 5 anchor ('clear overview with well-signaled one-level-deep references; easy navigation').

5 / 5

Total

17

/

20

Passed

Description

92%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, trigger-first description with comprehensive, concrete action coverage and good synonym and product-name inclusion. Its only weakness is omitting a few natural setup/authentication phrasings that the body's own dispatch table treats as triggers.

DimensionReasoningScore

Specificity

The description enumerates concrete actions for every workflow the skill supports ("discover, browse, search, suggest, recommend, or install", "Author, validate, or import OASF records; push, sign, and publish", "claim and prove record ownership", "verify signatures, ownership claims, or security scans", "configure node content policies and prune jobs", "synchronize data between servers"), matching the body's dispatch table one-to-one. Coverage is comprehensive with no meaningful gaps, so it fits the 5 anchor rather than the 4 anchor's 'minor gaps'.

5 / 5

Completeness

It opens with an explicit trigger clause ("Use when the user asks to...") and then states what the skill does through a full list of concrete capabilities, clearly answering both when and what. This matches the 5 anchor; it is not a 4 because the 'when' guidance is explicit and trigger-phrased rather than merely adequate.

5 / 5

Trigger Term Quality

Good natural-term coverage including synonyms (discover/search/browse, suggest/recommend), artifact types ("MCP servers, A2A agents, or agent skills"), identity protocols, and host products ("VS Code Copilot, Claude Code, or Cursor"). It misses a few natural phrases the body itself lists as triggers — 'log in', 'set up a local directory', 'connection issues' — placing it at the 4 anchor ('a few natural terms missing') rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly staked out via distinctive vocabulary (OASF records, directory push/publish/sign, ownership claims via DNS/DID/SPIFFE/ANS), so it would rarely fire for an unrelated skill. The only conceivable overlap is with a generic 'install MCP server' skill, which is too minor to drop it from the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

19

/

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

agntcy/dir

Path

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