CtrlK
BlogDocsLog inGet started
Tessl Logo

agentsociety-create-agent

Use when creating or revising a custom agent type, when an experiment needs an agent class that does not yet exist in the workspace, or when the agent design must be sized against a simulation budget.

73

Quality

91%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A lean, highly actionable body with a clear validated workflow and good use of real reference files. The main defect is progressive disclosure: a large share of the signaled deeper paths (stages/, checklists/, artifacts/, subagent-prompts/) are absent from the bundle, leaving dangling references.

Suggestions

Add the missing bundle files the body points to (stages/intake.md, stages/design.md, stages/generate.md, stages/validate.md, checklists/compatibility.md, artifacts/templates.md, subagent-prompts/planner.md, implementer.md, reviewer.md), or remove/inline those references so no signaled path is dangling.

Remove the duplicated validator command block in the Validation section since the same commands already appear in the Scale Budget table; reference that table instead.

Consider collapsing the repeated 'do not subclass existing agents' guidance (Base Class section and Common Mistakes table) into one location to tighten the body further.

DimensionReasoningScore

Conciseness

The body is dense and high-signal, assuming Claude's competence (no explanations of what agents or Python are) and earning its tokens via tables, a flow graph, and command snippets; the only slack is a minor duplication of the validator commands, which does not rise to verbosity.

3 / 3

Actionability

It gives copy-paste-ready validator commands, concrete file paths, a base-class selection table, and executable snippets for both declarative (init_config JSON) and programmatic (discover_skill_sources) skill loading.

3 / 3

Workflow Clarity

A clear intake→design→generate→validate→register sequence is shown via a dot graph and stage notes, with an explicit validation checkpoint and a fix-and-rerun feedback loop ("run the validator yourself and fix any remaining issues").

3 / 3

Progressive Disclosure

The overview is well-organized and heavy detail is correctly externalized to the real references/ files, but the body signals many one-level-deep paths that do not exist in the bundle (stages/intake.md, stages/validate.md, checklists/compatibility.md, artifacts/templates.md, subagent-prompts/*.md), so navigation is only partially reliable.

2 / 3

Total

11

/

12

Passed

Description

90%

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 strong, third-person description with an explicit Use-when trigger, clear niche, and natural phrasing. Its only weakness is a somewhat narrow enumeration of concrete actions, which keeps specificity at 2 rather than 3.

DimensionReasoningScore

Specificity

Names the domain and two actions ("creating or revising a custom agent type") but the concrete action list is narrow compared to the score-3 anchor that enumerates several distinct operations; it is more than vague yet not a comprehensive action set.

2 / 3

Completeness

It explicitly states what the skill does (create/revise a custom agent type) and when to use it via an explicit "Use when..." clause with concrete triggers, satisfying both halves.

3 / 3

Trigger Term Quality

Natural phrasings a user would actually say ("creating or revising a custom agent type", "agent class that does not yet exist") are covered well, and the explicit "Use when" clause surfaces multiple trigger variants.

3 / 3

Distinctiveness Conflict Risk

It targets a clear niche (custom agent classes in the agentsociety workspace) with triggers unlikely to fire for unrelated skills, and even disambiguates from discovery tasks.

3 / 3

Total

11

/

12

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.

Validation15 / 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
tsinghua-fib-lab/AgentSociety
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.