CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

perplexity-cli-models

Model selection guide for perplexity-cli ask and chat commands. Use when choosing between sonar, sonar-pro, sonar-reasoning, and sonar-deep-research.

Quality

86%

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

82%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.

A strong reference body: executable examples throughout, a genuinely useful decision flowchart, and tight, table-driven organization with no padding or background-concept filler. The main improvement opportunities are consolidating redundant bullets/examples and adding basic error handling to the batch agent pattern.

Suggestions

Trim bullets that restate the comparison table (e.g., "Any question where speed > depth", "Long wait times are acceptable") and cut each model section to one representative command.

Add a validation checkpoint to the batch agent loop (e.g., check exit status or jq output before synthesis) so the Cost-Aware section models a feedback loop.

Consider moving the per-model example commands into a references/ file, keeping SKILL.md as the comparison table plus flowchart.

DimensionReasoningScore

Conciseness

The body is dense with signal — comparison tables, tight bullet lists, and runnable commands — with no explanation of concepts Claude already knows. Minor trimming is possible: a few bullets restate the table ("Any question where speed > depth", "Questions where coverage > speed", "Long wait times are acceptable"), and each model section could carry one example instead of two or three. This fits the 'efficient; minor instances that could be trimmed' anchor, not 3 (which would need noticeably unnecessary explanation) or 5 (nothing trimmable).

4 / 5

Actionability

Every section is built on fully executable, copy-paste-ready commands with real flags (`--model sonar-pro --recency month`, `--model sonar-reasoning --reasoning high`, `--mode academic`) and examples covering the common cases for all four models, the reasoning-effort levels, and an agent loop piping through jq. Nothing is pseudocode or hand-wavy.

5 / 5

Workflow Clarity

The Decision Flowchart gives an explicit, unambiguous sequence for the skill's core task (choose a model), which alone would support 5 under the simple-skill exception. What holds it at 4 is the Cost-Aware Agent Usage batch loop: it has no error handling or validation checkpoint (a failed query silently drops out of the loop), so a minor validation gap remains. Not 3, because the batch loop is an illustrative read-only pattern, not the skill's primary workflow, and not 5 because that pattern lacks checkpoints.

4 / 5

Progressive Disclosure

The body is well organized into clearly signaled sections (comparison, per-model guidance, reasoning effort, flowchart, agent usage) with no buried references and no bundle files to navigate. At ~135 lines it exceeds the under-50-lines simple-skill case where sections alone earn a 5; the per-model example commands could live in a references file, so 'good structure, minor organization gaps' is the best fit rather than the fully-split ideal.

4 / 5

Total

17

/

20

Passed

Description

82%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.

A well-crafted description: explicit what and when clauses, third-person voice, and the right domain keywords (tool name plus all four model names). Its only weakness is that the 'what' is a single, somewhat generic action (a selection guide) rather than an enumeration of concrete capabilities.

Suggestions

Enumerate concrete capabilities in the 'what' clause, e.g. 'Compares speed, cost, and best-use cases for perplexity-cli models and recommends when to use sonar, sonar-pro, sonar-reasoning, or sonar-deep-research.'

Add the other natural trigger terms users would say, such as the "search" command and the "--model" flag, to broaden keyword coverage.

DimensionReasoningScore

Specificity

The description names its domain concretely — "Model selection guide for perplexity-cli ask and chat commands" — but that is a single action (guiding selection), matching the 'names domain and 1-2 concrete actions, not comprehensive' anchor. It does not merit 4, which requires several listed actions; the enumerated model names add scope detail, not additional actions.

3 / 5

Completeness

Both parts are explicit: the 'what' is "Model selection guide for perplexity-cli ask and chat commands" and the 'when' is "Use when choosing between sonar, sonar-pro, sonar-reasoning, and sonar-deep-research" — a concrete trigger clause. This matches the top anchor (clear, explicit what AND when with concrete triggers), not 4 where the 'when' would be less specific.

5 / 5

Trigger Term Quality

Strong keyword coverage: "perplexity-cli", "ask", "chat", and all four model names ("sonar", "sonar-pro", "sonar-reasoning", "sonar-deep-research") are exactly what a user would mention. A few natural terms are missing (e.g., "search" command, "--model" flag, "which model"/"reasoning effort" phrasing), which holds it at the 'good coverage, a few natural terms missing' anchor rather than the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to one tool's model flag and names the exact models, giving it a clear niche with minimal overlap risk against other skills. Nothing generic remains that would trigger the wrong skill.

5 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

slurpyb/perplexity-cli

Path

.claude/skills/web-search-with-perplexity/models/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.