CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

skill-registry

Trigger: update skills, skill registry, actualizar skills, after skill changes. Index available skills by trigger and path.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

88%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.

The body is a lean, highly actionable operational contract: exact commands and flags, exact persistence parameters, a decision table for edge cases, and explicit error-handling branches at every step of the workflow. Only minor issues hold it back — slight duplication between Hard Rules and Execution Steps, and References entries that point outside the provided bundle.

DimensionReasoningScore

Conciseness

The body is tight and project-specific with no over-explanation of concepts Claude already knows (it never explains what a registry or .gitignore is), but the command "gentle-ai skill-registry refresh --cwd <project>" and the Engram keys ("topic_key: skill-registry", "capture_prompt: false") each appear twice — once in Hard Rules and again in Execution Steps — which is minor redundancy that could be trimmed, placing it just below anchor 5's "every token earns its place".

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: the exact command with flags ("gentle-ai skill-registry refresh --cwd <project>" plus "--force"), the exact output path ".atl/skill-registry.md", exact persistence parameters ("title: skill-registry", "topic_key: skill-registry", "type: config", "capture_prompt: false"), and a concrete Decision Gates table — matching anchor 5's "fully executable; copy-paste ready code or commands".

5 / 5

Workflow Clarity

The five execution steps are clearly sequenced with explicit validation checkpoints and error-recovery branches — "If it reports the refresh was skipped (not a project), stop", "If it fails, report the error instead of scanning by hand", and the availability-gated manual-scan fallback in step 2 — matching anchor 5's explicit validation steps and error-recovery handling rather than anchor 4's 'minor validation gaps'.

5 / 5

Progressive Disclosure

Good structure with well-labeled sections and a clearly signaled, one-level-deep References section where each entry carries a one-line description. The minor gap: the referenced paths ("docs/skill-style-guide.md", "skills/_shared/skill-resolver.md") are not present in the skill bundle (no references/, scripts/, or assets/ files ship alongside SKILL.md), so navigation cannot be verified to resolve — one step below anchor 5's "easy navigation".

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.

The description explicitly answers both what ("Index available skills by trigger and path") and when ("Trigger: update skills, skill registry, actualizar skills, after skill changes") with reasonably natural trigger terms, including a Spanish variant. Its main weakness is thin action coverage — a single indexing action — and missing natural trigger phrases for the install/remove/create/rename operations the body's Activation Contract covers.

Suggestions

Broaden the capability clause beyond the single 'index' action to name several concrete outputs (e.g., "Build .atl/skill-registry.md listing each skill's name, trigger, scope, and exact path, deduplicated across user and project levels") to lift specificity toward anchor 4.

Add the natural trigger phrases the Activation Contract already covers — install, remove, create, move, or rename skills, and 'needs a fresh skill index' — so trigger coverage matches how users would actually phrase those requests.

DimensionReasoningScore

Specificity

The 'what' clause "Index available skills by trigger and path" names the domain and one concrete action with two organizing dimensions, matching anchor 3 ("Names domain and 1-2 concrete actions, but not comprehensive") rather than anchor 4, since it does not list several specific actions like the persist-to-Engram, dedup, or manual-scan behaviors the body actually performs.

3 / 5

Completeness

Both parts are explicit and concrete: 'what' is "Index available skills by trigger and path" and 'when' is the explicit trigger clause "Trigger: update skills, skill registry, actualizar skills, after skill changes", fitting anchor 5's "clearly and explicitly answers both what AND when with concrete trigger phrases". It exceeds anchor 4 because the 'when' is fully explicit, not weakly implied.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present — "update skills", "skill registry", "after skill changes" — plus a synonym variant "actualizar skills", giving good coverage. It stops short of anchor 5 because common natural terms for the other activating operations (install, remove, create, move, rename, refresh) are missing.

4 / 5

Distinctiveness Conflict Risk

"skill registry" carves a clear niche with distinct triggers, but "update skills" and "after skill changes" could minorly overlap with skill-authoring/editing skills, matching anchor 4's "mostly distinct; minor overlap risk with closely related skills" rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

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

Gentleman-Programming/gentle-ai

Path

internal/assets/skills/skill-registry/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.