agent-persona-creator

Design and draft AI agent persona documents for agent marketplaces, especially agency-agents style profiles. Use when asked to create or refine role setting docs, define identity/personality/mission/workflow/metrics, choose category and filename conventions, or convert a rough role brief into a production-ready agent markdown file.

Quality

86%

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

81%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 content is concise, actionable, and structured around a clear five-step workflow ending in explicit validation, with a genuine reference map to two real files. The main weakness is referencing a scripts/create_agent_profile.py and scripts/ that do not exist in the bundle.

Suggestions

Add the referenced scripts/create_agent_profile.py and scripts/lint-agents.sh to the bundle (or remove the references) so the cited commands are executable.

Convert the Reference Map entries to explicit links (e.g. [references/agency-agents-patterns.md](references/agency-agents-patterns.md)) for clearer navigation.

Tighten section intros like 'Collect the minimum brief before drafting' to remove the few remaining non-essential phrases.

Dimension	Reasoning	Score
Conciseness	The body is lean and bullet-driven with no padding about concepts Claude already knows (e.g. 'Reject broad scopes that cannot be measured'), but a few section intros like 'Collect the minimum brief before drafting' could be tightened, so it is just below the fully lean anchor.	4 / 5
Actionability	Concrete, executable guidance is present (a named lint command 'bash scripts/lint-agents.sh <path-to-agent-file>' and an explicit self-review checklist with specific items), but 'scripts/create_agent_profile.py' is referenced and no scripts/ directory exists, leaving a minor execution gap.	4 / 5
Workflow Clarity	A clear five-step sequence culminates in an explicit validation/self-review step (Step 5) with a concrete verification checklist and a lint feedback loop, matching the anchor for clear sequencing with explicit validation checkpoints.	5 / 5
Progressive Disclosure	The body is a well-organized overview with a dedicated 'Reference Map' pointing to two real, one-level-deep reference files, but the references are described in prose rather than linked and the referenced scripts/ files do not exist, leaving minor organization gaps.	4 / 5
	Total	17 / 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.

The description is third-person, specific, and explicitly pairs a clear 'what' with concrete 'Use when' triggers, covering the persona-creation lifecycle comprehensively. The only mild gap is slightly thinner synonym/file-extension coverage in trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions across the persona lifecycle: 'Design and draft AI agent persona documents', 'define identity/personality/mission/workflow/metrics', 'choose category and filename conventions', and 'convert a rough role brief into a production-ready agent markdown file', matching the comprehensive-coverage anchor.	5 / 5
Completeness	Clearly states what the skill does ('Design and draft AI agent persona documents for agent marketplaces') and gives an explicit 'Use when...' clause with concrete trigger scenarios, satisfying the top anchor.	5 / 5
Trigger Term Quality	Natural phrases users would say are well covered ('create or refine role setting docs', 'convert a rough role brief', 'production-ready agent markdown file'), but a few common synonyms and explicit file/extension terms are missing, so it sits just below the comprehensive anchor.	4 / 5
Distinctiveness Conflict Risk	A clear niche (agent marketplace persona documents, agency-agents style profiles) with distinct, domain-specific triggers means minimal conflict risk with unrelated skills.	5 / 5
	Total	19 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 2 missing	Warning

	Total	15 / 16 Passed

Repository: Jamailar/Beav
Path: desktop/electron/system-skills/agent-persona-creator/SKILL.md
Commit: e8cbd6a

Reviewed: 4 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.