agentfolio

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Quality

21%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/agentfolio/SKILL.md

Quality

Content

20%Scale 1-3

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

This skill is essentially a high-level guide to browsing a website, padded with generic advice about evaluating software products. It provides no technical depth, no executable code or commands, and no information that Claude couldn't easily infer. The content would benefit enormously from being reduced to a fraction of its current length and adding concrete, actionable elements like API usage, structured output schemas, or specific data extraction techniques.

Suggestions

Remove all generic advice Claude already knows (how to open a browser, what autonomous agents are, how to evaluate software) and reduce the skill to its unique, non-obvious content.

Add concrete, actionable outputs—e.g., a specific comparison table schema, a structured JSON format for agent evaluations, or actual API/scraping code if AgentFolio has an API.

If AgentFolio has no API and this is purely a 'visit a website' skill, reconsider whether it merits a skill file at all, or condense it to under 20 lines with just the URL and the key evaluation dimensions.

Remove the 'Example Prompts' section—these are meta-instructions about how to invoke the skill, not actionable content within the skill itself.

Dimension	Reasoning	Score
Conciseness	The skill is highly verbose and explains concepts Claude already knows (what AgentFolio is, what autonomous agents are, how to use a search bar, how to open a browser). Much of the content is generic advice about evaluating software that adds no unique value. The 'Capabilities' section largely restates the introduction, and the 'When to Use' section repeats what was already said.	1 / 3
Actionability	The skill provides no concrete, executable guidance—no code, no API calls, no CLI commands, no structured output formats. It's entirely abstract advice like 'visit a website' and 'use the search bar.' There's nothing copy-paste ready or technically specific that Claude couldn't infer on its own.	1 / 3
Workflow Clarity	The steps are listed in a logical sequence and the example workflows provide reasonable structure. However, there are no validation checkpoints, no concrete outputs to verify against, and no feedback loops. The workflows are more like checklists of vague activities than precise operational sequences.	2 / 3
Progressive Disclosure	The content is organized into clear sections with headers, which is good. However, there are no bundle files or external references to offload detail, and the content is somewhat monolithic—the example workflows and prompts sections could be separated. For a skill with no bundle, the inline content is longer than it needs to be.	2 / 3
	Total	6 / 12 Passed

Description

22%Scale 1-3

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 too vague and lacks both concrete actions and explicit trigger guidance. While it names the domain (AI agents) and the specific tool (AgentFolio), it fails to specify what concrete operations the skill performs or when Claude should select it. The description reads more like a tagline than a functional skill description.

Suggestions

Add a 'Use when...' clause with trigger terms like 'find an AI agent', 'search for autonomous agents', 'AgentFolio', 'compare AI tools', 'agent directory'.

Replace 'discovering and researching' with specific concrete actions such as 'Search the AgentFolio directory by category, filter agents by capability, compare agent features, retrieve agent details and documentation'.

Include common user phrasings and file/format references if applicable, e.g., 'Use when the user asks to find, compare, or learn about autonomous AI agents, AI tools, or agent frameworks'.

Dimension	Reasoning	Score
Specificity	The description uses vague language like 'discovering and researching' without listing concrete actions. It doesn't specify what operations can be performed (e.g., search by category, compare agents, filter by capability).	1 / 3
Completeness	The description provides a weak 'what' (discovering and researching agents) but completely lacks a 'when' clause or explicit trigger guidance. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also vague, so this scores a 1.	1 / 3
Trigger Term Quality	Includes some relevant keywords like 'AI agents', 'tools', 'ecosystems', and the product name 'AgentFolio', but misses common user phrasings like 'find an agent', 'agent directory', 'agent search', 'AI tool comparison', or 'agent marketplace'.	2 / 3
Distinctiveness Conflict Risk	The mention of 'AgentFolio directory' provides some distinctiveness as a specific product/tool, but 'AI agents, tools, and ecosystems' is broad enough to potentially overlap with other AI-related research or discovery skills.	2 / 3
	Total	6 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: popey/claude-code-skills
Path: skills/agentfolio/SKILL.md
Commit: a5a6601

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