CtrlK
BlogDocsLog inGet started
Tessl Logo

generate-agent

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

Quality

73%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./.github/skills/generate-agent/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
canonical/copilot-collections
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.