my-custom-skill

Example custom agent skill — a template to get started.

Quality

46%

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

Fix and improve this skill with Tessl

tessl review fix ./packages/agentsociety2/agentsociety2/custom/skills/examples/my-custom-skill/SKILL.md

Quality

Content

67%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 a well-structured, concise template that explains the two valid skill patterns and gives a concrete worked example. Its main weakness is actionability: guidance is mostly instructional prose and tool-call descriptions rather than copy-paste executable code.

Suggestions

Convert the Daily Journal example into a concrete, runnable code or command block instead of tool-invocation prose to lift actionability.

Replace the abstract Behavioral Guidelines ('Use ask_env to query the environment for relevant information') with specific, parameterized invocations.

Link the script as scripts/my-custom-skill.py in Pattern B so the reference is clearly signaled as a navigable file.

Dimension	Reasoning	Score
Conciseness	The body is lean and instructional, covering skill-specific patterns rather than concepts Claude already knows, with only minor asides like 'like Claude Code's slash commands' that could be trimmed.	4 / 5
Actionability	The Daily Journal example names specific tools and paths (ask_env, read journal.jsonl, append, finish), but guidance is tool-invocation prose rather than executable code and the Behavioral Guidelines section stays abstract.	3 / 5
Workflow Clarity	Both the Behavioral Guidelines and Daily Journal example lay out a clear numbered sequence; this is a simple non-destructive task so missing validation checkpoints are a minor rather than disqualifying gap.	4 / 5
Progressive Disclosure	Sections are well organized (How Skills Work, Pattern A/B, Behavioral Guidelines, Example) and the one bundle file scripts/my-custom-skill.py exists and is referenced one level deep, though the reference is prose rather than a clear markdown link.	4 / 5
	Total	15 / 20 Passed

Description

25%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 a placeholder-quality template label: it states a vague purpose and provides no trigger guidance, concrete actions, or distinguishing cues. It reads as boilerplate rather than a discoverable, actionable skill description.

Suggestions

Replace 'a template to get started' with concrete capabilities the skill provides (e.g., 'Scaffolds a new custom agent skill with prompt-only or script entry points').

Add an explicit trigger clause such as 'Use when creating or scaffolding a custom agent skill'.

Include natural user-facing terms and file extensions (e.g., 'SKILL.md', 'skill template') to improve distinctiveness and trigger matching.

Dimension	Reasoning	Score
Specificity	The phrase 'custom agent skill' names the domain, but the only action offered is 'a template to get started', which is generic with no concrete capabilities listed.	2 / 5
Completeness	It gives a vague 'what' ('a template to get started') and entirely omits any 'when to use it' guidance, fitting the anchor for a vague what with no when.	2 / 5
Trigger Term Quality	There are no natural trigger phrases a user would say ('Use when…' is absent) and only generic keywords like 'custom agent skill' and 'template' appear.	2 / 5
Distinctiveness Conflict Risk	'Example custom agent skill — a template to get started' is very broad and would overlap with virtually any skill-authoring or template skill, though it names a niche rather than being fully generic.	2 / 5
	Total	8 / 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: 1 missing	Warning

	Total	15 / 16 Passed

Repository: tsinghua-fib-lab/AgentSociety
Path: packages/agentsociety2/agentsociety2/custom/skills/examples/my-custom-skill/SKILL.md
Commit: 13e28b5

Reviewed: 1 day 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.