CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

claude-automation-recommender

Recommend Claude Code automations (hooks, subagents, skills, plugins, MCP) and review an existing setup.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./resources/builtin-agents/cherry-assistant/.claude/skills/claude-automation-recommender/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 strong example of an overview-plus-references skill: a clearly phased workflow, concrete executable commands and paths, a copy-paste output template, and clean one-level-deep delegation to five real reference files. Its main weakness is token efficiency — the Cherry Studio-specific Phase 0 and the tangential Configuration Tips section add ~70 lines that don't serve the core recommendation task.

Suggestions

Move the 'Configuration Tips' section (headless mode, hook permissions JSON, MCP debugging) into a reference file (e.g. references/implementation-tips.md) or delete it — it guides implementation, which the skill explicitly says it does not do.

Compress Phase 0 to ~10 lines: keep the token-cost disclosure and the yes/no gate, but drop the bilingual example blockquotes and the per-alternative explanations; or gate it behind an explicit 'skip if token budget is not a concern' condition.

Merge the 'Automation Types Overview' table into the Decision Framework (its 'When to Recommend X' lists already cover the same ground) to remove the duplication.

DimensionReasoningScore

Conciseness

The signal→recommendation tables are dense, non-obvious knowledge and the details are pushed to references/, which is efficient. But several sections could be trimmed: the ~36-line 'Phase 0: Confirm Before Scanning (Cherry Studio addition)' with bilingual example blockquotes, the ~35-line 'Configuration Tips' section (headless mode, permissions JSON, MCP debugging) that drifts beyond the skill's stated read-only recommend role, and the partial duplication between the 'Automation Types Overview' table and the 'Decision Framework' when-to-recommend lists. This fits anchor 3 ('Mostly efficient but includes some unnecessary explanation or could be tightened') — not 4 because the tangential Configuration Tips section and Phase 0 padding are more than minor instances, and not 2 because the core body is well-structured mapping tables, not padded concept explanation.

3 / 5

Actionability

Quotes: executable analysis commands ('ls -la package.json pyproject.toml...', 'cat package.json ... | grep -E ...'), exact paths ('.claude/skills/<name>/SKILL.md', '.claude/agents/[name].md', '.claude/settings.json'), a copy-paste-ready Phase 3 output template, a YAML frontmatter example with 'disable-model-invocation: true', and concrete commands ('claude mcp add context7', 'claude -p ... --output-format stream-json'). This matches anchor 5 ('Fully executable; copy-paste ready code or commands; specific examples cover the common cases') — the small gaps (hook configs deferred to references/hooks-patterns.md) are appropriate delegation, not missing detail.

5 / 5

Workflow Clarity

Quotes: a clearly labeled sequence 'Phase 0: Confirm Before Scanning' → 'Phase 1: Codebase Analysis' → 'Phase 2: Generate Recommendations' → 'Phase 3: Output Recommendations Report', with Phase 0 acting as an explicit user-confirmation checkpoint ('Wait for explicit yes... before proceeding to Phase 1') and Phase 1 ending with a 'Key Indicators to Capture' table. This matches anchor 4 ('Clear sequence with most checkpoints present; minor validation gaps') — not 5 because there are no explicit validation/feedback steps (e.g., verifying a detected framework before recommending against it), though as a read-only analysis skill it lacks the destructive/batch operations that would trigger the lower cap.

4 / 5

Progressive Disclosure

Quotes: each category section opens with a one-level-deep, well-signaled pointer — 'See [references/mcp-servers.md](references/mcp-servers.md) for detailed patterns', plus the same for skills-reference.md, hooks-patterns.md, subagent-templates.md, and plugins-reference.md. All five files exist, contain real detail content (181–408 lines), and contain no chained references, and the body keeps only compact summary tables inline. This matches anchor 5 ('Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation').

5 / 5

Total

17

/

20

Passed

Description

61%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 names a clear niche (Claude Code extensibility) with strong type-level trigger terms, but it has no explicit 'when to use' guidance and its actions are generic verbs. Adding a 'Use when...' trigger clause and one more concrete phrase about what the recommendations cover would lift it substantially.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants to extend or optimize Claude Code — setting up hooks, subagents, skills, plugins, or MCP servers — or wants an audit/review of their existing Claude Code configuration.'

Make the actions slightly more concrete, e.g. 'Recommends specific Claude Code automations (hooks, subagents, skills, plugins, MCP servers) matched to a codebase, and reviews an existing .claude/ setup for gaps' — this also adds the natural terms 'audit' and '.claude/'.

Include a few natural user phrasings as triggers ('automate Claude Code', 'extend Claude Code', 'set up hooks/MCP') to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Quotes: 'Recommend Claude Code automations (hooks, subagents, skills, plugins, MCP) and review an existing setup.' It names the domain and two actions ('Recommend... automations', 'review an existing setup'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because the verbs stay generic — it never says what the recommendations consist of or what a review covers — and not a 2 because the parenthetical enumeration of all five extensibility types goes beyond minimal/generic.

3 / 5

Completeness

Quotes: the 'what' is clear ('Recommend Claude Code automations... and review an existing setup'), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It matches anchor 3 ('Has a clear what but when is missing or only weakly implied') — not 4 because the guidelines require an explicit 'when' for that level.

3 / 5

Trigger Term Quality

Quotes: 'hooks, subagents, skills, plugins, MCP' plus 'Claude Code automations'. These are the exact nouns a user would naturally say when needing this skill ('add a hook', 'which MCP servers should I use'), giving good keyword coverage. Not a 5 because common natural phrasings like 'set up', 'configure', 'extend Claude Code', or 'audit my setup' are absent; not a 3 because the five type names are specific, high-value trigger terms rather than generic keywords with missing variations.

4 / 5

Distinctiveness Conflict Risk

Quotes: 'Claude Code automations (hooks, subagents, skills, plugins, MCP)' — a clear niche (Claude Code extensibility survey) with distinct trigger nouns, so it would not fire for unrelated skills. Not a 5 because it overlaps with more focused skills like a hooks-configuration or MCP-setup skill, matching anchor 4 ('Mostly distinct; minor overlap risk with closely related skills'); not a 3 because the enumerated type list and 'Claude Code' scoping make it more specific than 'somewhat specific but could still overlap'.

4 / 5

Total

14

/

20

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

CherryHQ/cherry-studio

Path

resources/builtin-agents/cherry-assistant/.claude/skills/claude-automation-recommender/SKILL.md

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.