agentskills

Agent Skills portable format router. Use when creating cross-client skills, validating portable frontmatter, packaging skills for upload or API use, or implementing skill discovery and activation.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

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

An exemplary router skill: a compact overview that branches cleanly to three real, one-level-deep reference files with no inlined bulk and no verbosity. The only weakness is a small amount of time-sensitive material (an access date and a version-dated cross-reference) that sits outside a dedicated section.

Suggestions

Move the '(accessed 2026-09-24)' citation date and the version-dated 'plugin-creator:claude-skills-overview-2026' pointer into a stable section (e.g., 'Sources' or 'Deprecated/old patterns') or drop the date to keep the body evergreen.

Optionally state one-line decision criteria per branch in the same sentence as each link so the router decision is fully self-contained even before loading a reference.

Dimension	Reasoning	Score
Conciseness	The body is lean and router-shaped with no padding, but it carries time-sensitive tokens — '(accessed 2026-09-24)' and the version-dated 'plugin-creator:claude-skills-overview-2026' pointer — outside any 'old patterns'/'deprecated' section, a minor trim candidate per the guideline.	4 / 5
Actionability	For an instruction-only router skill the guidance is fully executable: a labeled three-way branch decision ('Schema or validation', 'Authoring', 'Client implementation') each pointing to an exact, existing file path, plus a concrete list of accepted frontmatter fields.	5 / 5
Workflow Clarity	A simple single-purpose skill whose one action — match the current branch and load the corresponding reference — is unambiguous and needs no validation checkpoints since nothing destructive or batch-oriented is performed.	5 / 5
Progressive Disclosure	The body is a clear overview with well-signaled one-level-deep references; all three linked files (specification.md, best-practices.md, integration.md) exist in ./references/ and contain only internal anchors, not nested reference chains.	5 / 5
	Total	19 / 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 tight, well-structured description that names a concrete role, enumerates four specific capabilities, and provides an explicit 'Use when' trigger clause. Trigger phrasing could add a few user-natural synonyms, but conflict risk and completeness are excellent.

Dimension	Reasoning	Score
Specificity	Lists four concrete capabilities — 'creating cross-client skills, validating portable frontmatter, packaging skills for upload or API use, or implementing skill discovery and activation' — giving comprehensive coverage of the format-router role rather than the minor gaps of the anchor below.	5 / 5
Completeness	Explicitly answers both: 'what' via 'Agent Skills portable format router' and 'when' via the 'Use when…' clause enumerating four concrete trigger scenarios, matching the anchor-5 pattern exactly.	5 / 5
Trigger Term Quality	Good natural keyword coverage ('creating cross-client skills', 'packaging skills', 'frontmatter', 'discovery and activation'), but misses common variations users would plausibly say such as 'SKILL.md', 'portable skill format', or 'skill validation' on its own.	4 / 5
Distinctiveness Conflict Risk	Clear niche with distinct triggers around the portable cross-client format; it scopes away from runtime extensions and is unlikely to fire for unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: Jamie-BitFlight/claude_skills
Path: plugins/plugin-creator/skills/agentskills/SKILL.md
Commit: 3e0b2af

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.