CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

perplexity-cli-schemas

JSON input and output schemas for all perplexity-cli commands (search, ask, chat). Use when constructing --json payloads or parsing command output programmatically.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

An excellent executable reference: complete input/output schemas, copy-paste payloads, practical jq recipes, and a CLI-to-JSON mapping table with the key comma-string-vs-array gotcha called out. The only trims are the maximal payload examples that restate the schema blocks, and the single-file layout is acceptable but sits at the boundary where a per-command split would help.

DimensionReasoningScore

Conciseness

The body is a dense reference with no padding or explanations of concepts Claude already knows — field notes, backend-difference gotchas, and a mapping table all earn their tokens. The maximal payload blocks for search and ask largely restate the preceding schema listings with example values, which is the kind of minor over-explanation that could be trimmed, matching the 4 anchor rather than 5's 'every token earns its place'.

4 / 5

Actionability

Copy-paste-ready minimal and maximal JSON payloads, five runnable jq one-liners per output schema, and a complete CLI-to-JSON field mapping table. Everything is executable and the examples cover the common cases (extract URLs, snippets, citations, token usage), matching the 5 anchor.

5 / 5

Workflow Clarity

This is a single-purpose reference/lookup skill with no multi-step process and no destructive or batch operations, so the simple-skill exception applies: the single action (consult the schema, construct or parse a payload) is unambiguous, and sections are cleanly organized per command with input, output, and mapping each clearly delineated.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so all content is inline in a ~230-line file with well-organized per-command sections and one clearly signaled one-level-deep reference (../models/SKILL.md). Structure is good, matching the 4 anchor; it is not the 5 anchor's overview-pointing-to-split-files pattern, and the under-50-lines exception for a top score does not apply.

4 / 5

Total

18

/

20

Passed

Description

87%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 concise, well-targeted description that clearly states what the skill provides and gives an explicit 'Use when' clause with concrete trigger phrases. Trigger-term coverage is good but omits a few natural variations. No vague fluff or over-claims.

DimensionReasoningScore

Specificity

"JSON input and output schemas for all perplexity-cli commands (search, ask, chat)" names the domain and concrete actions ("constructing --json payloads", "parsing command output") with named commands, matching the anchor for several specific actions with minor gaps. It stops short of the 5 anchor's comprehensive multi-action enumeration, but exceeds the 1-2 concrete actions of the 3 anchor.

4 / 5

Completeness

It explicitly answers both: what ("JSON input and output schemas for all perplexity-cli commands (search, ask, chat)") and when ("Use when constructing --json payloads or parsing command output programmatically") with concrete trigger phrases. This matches the 5 anchor exactly; the explicit 'Use when' clause means the missing-trigger cap at 3 does not apply.

5 / 5

Trigger Term Quality

Natural user phrasing is present — "JSON", "--json payloads", "parsing command output programmatically", "schemas", plus the command names search/ask/chat — giving good keyword coverage. A few natural terms are missing (e.g., "fields", "stdin", "jq", "response format"), so it fits the 4 anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a specific tool (perplexity-cli) with JSON-specific triggers (--json payloads, programmatic output parsing), creating a clear niche distinct from general web-search or sibling perplexity-cli skills (e.g., the referenced models/SKILL.md). Minimal conflict risk matches the 5 anchor.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

slurpyb/perplexity-cli

Path

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