CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-identifier

Use when creating or configuring Claude Code agents and their frontmatter.

49

Quality

54%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/agent-identifier/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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-structured instructional skill: concrete templates, field-by-field formats with good/bad examples, and a validated 9-step workflow. Its weaknesses are redundancy in the Quick Reference sections, placeholder-only examples with no fully worked agent, and a bundle that does not match the body's promises (examples/ directory and one test script are missing).

Suggestions

Create the missing referenced files (examples/agent-creation-prompt.md, examples/complete-agent-examples.md, scripts/test-agent-trigger.sh) or remove the references so the bundle matches the body.

Consolidate the duplicated identifier rules and DO/DON'T lists (Frontmatter Fields vs. Validation Rules vs. Quick Reference) into one location to cut the token cost.

Add one complete, fully worked example of a real agent file (not bracketed placeholders) and a 'if validation fails, fix and re-run' feedback loop in the implementation workflow.

DimensionReasoningScore

Conciseness

The body is mostly efficient and does not lecture on concepts Claude already knows, but it could be tightened: identifier rules ("3-50 characters, lowercase, hyphens") are stated twice (Frontmatter Fields and Validation Rules), the DO/DON'T best-practice lists appear twice, and the 'Minimal Agent' quick-reference template repeats the Complete Format example. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not a 4 because the Quick Reference section is largely redundant with earlier sections rather than a minor trim.

3 / 5

Actionability

The body gives concrete, usable artifacts: a complete agent file template, per-field formats with good/bad examples, a copy-paste AI-generation prompt, a frontmatter summary table, and a 9-step implementation workflow. Matches 'mostly executable guidance... with minor gaps'; not a 5 because the templates are placeholder scaffolds ([bracketed slots]) rather than one fully worked real example, and three referenced artifacts (examples/agent-creation-prompt.md, examples/complete-agent-examples.md, scripts/test-agent-trigger.sh) do not exist, so following them dead-ends.

4 / 5

Workflow Clarity

The Implementation Workflow gives a clear 9-step sequence with explicit checkpoints ("Validate with scripts/validate-agent.sh", "Test triggering with real scenarios"), and a separate Testing Agents section spells out verification steps. Matches 'clear sequence with most checkpoints present; minor validation gaps'; not a 5 because there is no feedback loop for validation failure (what to do when validate-agent.sh fails) and one referenced test script is missing.

4 / 5

Progressive Disclosure

Structure is genuinely good — overview in SKILL.md, a clearly labeled Additional Resources section, and one-level-deep references/ files that all exist — but scoring against the actual bundle: examples/agent-creation-prompt.md, examples/complete-agent-examples.md, and scripts/test-agent-trigger.sh are referenced and absent (the examples/ directory does not exist at all). Three of seven referenced paths dead-end, which is more than the 'minor organization gaps' of a 4, so the score sits between the 3 and 4 anchors, closer to 3.

3 / 5

Total

14

/

20

Passed

Description

45%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 has a clean, explicit trigger clause and a distinct domain, but it is a 'when'-only description: it never states what the skill provides and omits natural user phrasings like 'subagent' or 'write an agent'. It is serviceable but below the bar set by the good overall examples, which state capabilities and trigger conditions together.

Suggestions

Add a 'what' clause before the trigger, e.g., "Guidelines and templates for Claude Code agent files: frontmatter fields, triggering descriptions with <example> blocks, and system prompt structure. Use when creating, adding, or configuring agents (subagents)."

Include natural user phrasings as trigger terms — "subagent", "add an agent", "write an agent", "agent frontmatter" — since these are the phrases users actually say in this domain.

Add a brief negative boundary (e.g., "Not for slash commands, hooks, or MCP servers") to reduce conflict with neighboring plugin skills.

DimensionReasoningScore

Specificity

"Use when creating or configuring Claude Code agents and their frontmatter" names the domain (Claude Code agents, frontmatter) and 1-2 actions ("creating or configuring"), matching the anchor for naming a domain with concrete but non-comprehensive actions. It is not a 2 because the actions are concrete, not generic like "works with files"; not a 4 because only two actions are listed with no coverage of the skill's actual capabilities (trigger design, system prompts, tool selection).

3 / 5

Completeness

The description is a single 'Use when...' clause: it explicitly answers only WHEN ("Use when creating or configuring Claude Code agents and their frontmatter") with no statement of WHAT the skill provides (e.g., formats, templates, validation guidance). This mirrors the anchor example "Use when working with documents" — only 'when' present without 'what'; scoring only what is explicitly stated, the 'what' cannot be inferred per the judging guidelines. Not a 3 because that anchor requires a clear 'what' with weak 'when', which is the inverse of what is present.

2 / 5

Trigger Term Quality

Relevant keywords are present ("creating", "configuring", "agents", "frontmatter", "Claude Code") but common variations users would naturally say are missing — notably "subagent", "add an agent", "write an agent", and "agent file". Matches the anchor 'some relevant keywords but missing common variations or synonyms'; not a 4 because the synonym gap for a domain where "subagent" is the primary user term is more than 'a few natural terms missing'.

3 / 5

Distinctiveness Conflict Risk

"Claude Code agents and their frontmatter" carves a fairly clear niche that is unlikely to trigger for unrelated skills, with only minor overlap risk against closely related plugin skills (e.g., a plugin-structure skill). Matches 'mostly distinct; minor overlap risk'; not a 5 because the description does not name any disambiguating non-triggers (e.g., 'not slash commands or hooks') to make conflicts minimal.

4 / 5

Total

12

/

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.

Validation — 15 / 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
Galaxy-Dawn/claude-scholar
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.