Generates Custom Agent files (.github/agents/*.agent.md) with persona-based configurations, specialized tool sets, and role-specific cognitive architectures. Use when the user requests a specialized role or perspective (Security Auditor, Documentation Writer, Release Engineer, etc.). Creates agents with defined identity, constrained tools, and thinking processes aligned to their role. Not for general capabilities—use generate-agent-skills for those.
63
73%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.github/skills/generate-agent/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly communicates what the skill does (generates persona-based agent configuration files), when to use it (when users request specialized roles), and when NOT to use it (distinguishing from generate-agent-skills). The inclusion of concrete role examples as trigger terms and the explicit file path pattern make it highly specific and distinctive.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: generates Custom Agent files with persona-based configurations, specialized tool sets, role-specific cognitive architectures, defined identity, constrained tools, and thinking processes. Also specifies the file path pattern (.github/agents/*.agent.md). | 3 / 3 |
Completeness | Clearly answers both 'what' (generates Custom Agent files with persona-based configurations, specialized tool sets, cognitive architectures) and 'when' (when user requests a specialized role or perspective, with examples). Also includes a negative boundary ('Not for general capabilities—use generate-agent-skills for those'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'specialized role', 'perspective', 'Security Auditor', 'Documentation Writer', 'Release Engineer', 'agent', 'persona'. The concrete role examples serve as excellent trigger terms that match how users would phrase requests. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche: persona-based agent files in a specific file path. The explicit negative boundary distinguishing it from generate-agent-skills further reduces conflict risk. The focus on role-specific agents with constrained tools is a well-defined domain. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
47%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill has excellent workflow structure with clear step sequencing, validation checkpoints, and a useful intent-routing decision tree. However, it is significantly over-verbose, repeating the same example agents (Security Auditor, Documentation Writer) across nearly every step, and includes substantial content that Claude already knows. The reliance on external reference files that aren't provided in the bundle weakens both actionability and progressive disclosure.
Suggestions
Cut inline examples by 60%—show one complete agent example end-to-end rather than repeating Security Auditor and Documentation Writer fragments in every step.
Either provide the referenced bundle files (role_analysis_checklist.md, tool_selection_guide.md, cognitive_architecture_patterns.md, agent_template.md) or inline the critical content from them, since the skill is not actionable without them.
Move the 'Examples of Common Agents' catalog and 'Anti-Patterns' sections to a reference file to reduce the main skill's token footprint.
Remove explanatory text that Claude already knows (e.g., what a Security Auditor does, what a Documentation Writer does) and focus on the structural/template requirements that are genuinely novel.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines. It over-explains concepts Claude already understands (what a Security Auditor does, what a Documentation Writer does), repeats examples multiple times across steps, includes unnecessary tables, and provides extensive anti-patterns and usage guidance sections. The role analysis examples, tool selection examples, and cognitive architecture examples all redundantly illustrate the same agents (Security Auditor, Documentation Writer). Much of this could be condensed to 1/3 the length. | 1 / 3 |
Actionability | The skill provides some concrete guidance (file naming conventions, bash commands for loading references, validation commands) but relies heavily on external reference files (role_analysis_checklist.md, tool_selection_guide.md, cognitive_architecture_patterns.md, agent_template.md) that are not provided in the bundle. The validation script path references a skills directory script for agent validation which seems incorrect. The template population step describes what to fill in but doesn't show the actual template content inline. | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced with a decision tree for intent validation (Step 1), explicit validation and testing checklist (Step 6), and a clear progression from role analysis through template population. The intent validation step acts as a routing checkpoint, and Step 6 includes a concrete validation checklist with verification commands and a final output format. | 3 / 3 |
Progressive Disclosure | The skill references four external files (references/role_analysis_checklist.md, references/tool_selection_guide.md, references/cognitive_architecture_patterns.md, assets/agent_template.md) which is good structure, but none of these bundle files are provided, making it impossible to verify they exist or contain useful content. Additionally, the main SKILL.md itself contains too much inline content (extensive examples, anti-patterns, common agents catalog) that could be moved to reference files, undermining the disclosure pattern. | 2 / 3 |
Total | 8 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
c5644f6
Table of Contents
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.