agent-app-store
Agent skill for app-store - invoke with $agent-app-store
40
7%
Does it follow best practices?
Impact
97%
2.85xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./.agents/skills/agent-app-store/SKILL.mdQuality
Discovery
0%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 description is critically deficient across all dimensions. It provides no information about what the skill does, when it should be used, or what domain it operates in. The only content is a generic label ('app-store') and an invocation command, which is insufficient for Claude to make informed skill selection decisions.
Suggestions
Add concrete actions describing what this skill does (e.g., 'Searches app store listings, retrieves app metadata, checks app availability and pricing').
Add an explicit 'Use when...' clause with natural trigger terms (e.g., 'Use when the user asks about finding apps, checking app reviews, app store listings, or mobile application information').
Specify which app store(s) this covers (iOS App Store, Google Play, etc.) to reduce ambiguity and conflict risk with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description contains no concrete actions whatsoever. 'Agent skill for app-store' is entirely vague and does not describe what the skill actually does. | 1 / 3 |
Completeness | Neither 'what does this do' nor 'when should Claude use it' is answered. The description only states it's an 'agent skill' and how to invoke it, providing no functional or contextual information. | 1 / 3 |
Trigger Term Quality | The only keyword is 'app-store' which is ambiguous and not a natural phrase users would say when requesting a specific task. No natural trigger terms are present. | 1 / 3 |
Distinctiveness Conflict Risk | 'App-store' is vague and could refer to many different things (iOS App Store, Google Play, internal app catalogs, etc.). There is no specificity to distinguish this from other potential skills. | 1 / 3 |
Total | 4 / 12 Passed |
Implementation
14%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is heavily padded with descriptive content about the agent's role, responsibilities, and marketplace features that provide little actionable guidance. While the MCP tool call examples are a strength, the skill lacks concrete workflows, validation steps, and proper content organization. Most of the content reads like a product marketing document rather than an executable skill definition.
Suggestions
Remove the verbose role description, category lists, quality standards, and marketplace features sections—replace with concise workflows for the 3-4 most common tasks (e.g., publish an app, deploy a template, search for apps).
Add step-by-step workflows with validation checkpoints, e.g., for publishing: validate metadata → run security check → publish → verify listing.
Move reference material like app categories and quality standards to a separate file and link to it, keeping SKILL.md as a lean operational guide.
Replace the abstract 'marketplace management approach' list with concrete decision trees or conditional logic for common scenarios (e.g., 'If user wants to publish → check required fields → call publish endpoint → verify response').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose with extensive lists of categories, quality standards, and marketplace features that Claude already understands conceptually. The role-playing preamble, bullet-point lists of responsibilities, and feature descriptions add significant token bloat without actionable value. | 1 / 3 |
Actionability | The JavaScript code examples for MCP tool calls are concrete and show actual function signatures with parameters, which is useful. However, much of the content is descriptive rather than instructive—it describes what the agent does rather than providing executable workflows for specific tasks. | 2 / 3 |
Workflow Clarity | There are no clear multi-step workflows with sequencing or validation checkpoints. The numbered list under 'marketplace management approach' describes abstract responsibilities, not actionable steps. Publishing an app, deploying a template, or managing versions have no defined step-by-step processes with error handling. | 1 / 3 |
Progressive Disclosure | The content is a monolithic wall of text with no references to external files or structured navigation. All categories, quality standards, and features are inlined despite being reference material that could be split out or omitted entirely. | 1 / 3 |
Total | 5 / 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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- ruvnet/claude-flow
- Commit
f547cec
- 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.