CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-hierarchy-diagram

Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding.

72

1.39x
Quality

50%

Does it follow best practices?

Impact

85%

1.39x

Average score across 6 eval scenarios

SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./skills/agent/agent-hierarchy-diagram-majiayu000-claude-skill-registr/SKILL.md

The canonical home for this skill is agent-hierarchy-diagram in majiayu000/claude-skill-registry

SKILL.md
Quality
Evals
Security

Quality

Content

38%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 well-sectioned and brief, but its entire actionable surface rests on two scripts that are not included in the bundle, making the commands unexecutable and all external references dangling. Sections are also duplicated ('When to Use' vs 'Use Cases') and validation is a vague mention rather than a step.

Suggestions

Ship the two referenced scripts in a scripts/ directory, or replace the Quick Reference with self-contained, copy-pasteable commands (e.g. inline the tree generation as a shell one-liner or provide the Mermaid source directly).

Merge the overlapping 'When to Use' and 'Use Cases' sections into one list to remove redundancy.

Turn 'Validate diagram accuracy' into an explicit checkpoint with a concrete command or comparison step against '.claude/agents/' so the workflow has a real validation point.

DimensionReasoningScore

Conciseness

The Quick Reference and format examples are lean, but 'When to Use' and 'Use Cases' are two separate sections saying nearly the same thing ('Documenting agent system for team' vs 'Include in onboarding documentation'), and the Output Formats one-liners ('Human-readable in terminals, copy-pasteable in docs') state what Claude already knows. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, since the duplication is more than a minor trim.

3 / 5

Actionability

The Quick Reference presents concrete-looking commands ('./scripts/generate_hierarchy_diagram.sh', './scripts/generate_mermaid_diagram.sh > hierarchy.mmd'), but no scripts/ directory exists in the bundle — the commands are not executable as written, leaving only high-level hints about what to run. This matches anchor 2 ('high-level hints but missing the specific steps to execute') rather than 3, because the gap is not a missing detail but the complete absence of the referenced tooling.

2 / 5

Workflow Clarity

The intended flow (run a script, redirect output, optionally validate with 'agent-test-delegation') is discernible but every executable step depends on scripts that don't exist, and validation is a vague pointer ('Validate diagram accuracy') with no command or checkpoint. This matches anchor 3 ('sequence present but checkpoints missing or implicit') rather than 4; the simple-skill exception can't lift it because the single action itself is not actually runnable.

3 / 5

Progressive Disclosure

The body references './scripts/generate_hierarchy_diagram.sh', './scripts/generate_mermaid_diagram.sh', '/agents/hierarchy.md', and '.claude/agents/', yet the bundle contains no scripts/, references/, or assets/ directories — every external pointer is dangling, so navigation leads nowhere. This matches anchor 2 ('minimal structure; references are buried/broken') rather than 3, because the well-organized sections are undermined by references to files that don't exist in the bundle.

2 / 5

Total

10

/

20

Passed

Description

62%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 serviceable description with a clear what/when split in third person and a reasonably distinct niche. Its weaknesses are limited specificity (no output formats or concrete diagram actions) and thin trigger-term coverage that misses natural synonyms like 'org chart' or 'team structure'.

Suggestions

List the concrete outputs in the description, e.g. 'Generate ASCII, Mermaid, and GraphML hierarchy diagrams of the agent system showing levels and delegation.'

Add natural trigger phrasing such as 'Use when the user asks for an org chart or visual of the agent team, or when onboarding contributors or writing agent documentation.'

DimensionReasoningScore

Specificity

The description names the domain ('visual hierarchy diagrams of agent system') and one to two concrete actions ('showing levels and delegation'), but is not comprehensive — the output formats (ASCII, Mermaid, GraphML) and diagram-generation actions detailed in the body are absent. It matches anchor 3 ('names domain and 1-2 concrete actions, but not comprehensive') rather than 4, which requires several specific listed actions.

3 / 5

Completeness

It answers both: what ('Generate visual hierarchy diagrams of agent system showing levels and delegation') and when ('Use for documentation or onboarding'), in third person. The 'when' clause is present but could be more explicit with concrete trigger phrases ('Use when the user asks for...'), matching anchor 4 rather than 5.

4 / 5

Trigger Term Quality

'documentation', 'onboarding', 'hierarchy', 'delegation', 'agent system' are relevant keywords, but common natural variations users would say are missing ('org chart', 'team structure', 'visualize the agent team', 'diagram of agents'). This matches anchor 3 ('some relevant keywords but missing common variations or synonyms'); it falls short of 4's 'good keyword coverage' because several natural phrasings are absent.

3 / 5

Distinctiveness Conflict Risk

The agent-system hierarchy niche is mostly distinct with clear triggers ('agent system', 'levels', 'delegation'), but a generic request to 'draw a diagram' or 'make an org chart' could overlap with general visualization/diagramming skills — matching anchor 4 ('mostly distinct; minor overlap risk'). It is more scoped than anchor 3's generic 'works with document files' style.

4 / 5

Total

14

/

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
majiayu000/claude-skill-registry
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.