CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

faq

Turn repeat questions into a pinned FAQ. Use when a champion keeps answering the same questions.

Quality

87%

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

92%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 tight, highly actionable instruction skill: exact questions with defaults, explicit consent checkpoints, fallback behavior for every failure mode, and a concrete FAQ frame, with no filler or known-concept explanation. Only minor tightening of the repeated consent/safety phrasing would improve it.

DimensionReasoningScore

Conciseness

The body is dense instruction with no explanation of concepts Claude already knows, but the consent rules are stated multiple times ("A default never counts as a yes", "still stop at every consent question", and the repeated consent language in the closing paragraph) and could be trimmed — efficient with minor repetition, matching 4 rather than the every-token-earns-its-place anchor at 5.

4 / 5

Actionability

The guidance is copy-paste ready for an instruction-only skill: exact question texts with defaults (questions 1-6), literal tool calls (Glob on "CLAUDE.md" and ".claude/settings.json", the repo-scout command list, AskUserQuestion options), and a concrete fill-in FAQ frame; per the code-vs-instruction note, the absence of code is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

The sequence is clear (check files, repo-scout, ask one question at a time, build the FAQ, deliver) with explicit validation checkpoints and fallbacks: "have the champion confirm the command", the local file as "a consent stop", "show it first, and write it only after the champion says yes", "If AskUserQuestion isn't available...", and "If it returns anything other than one exact entry, treat it as none".

5 / 5

Progressive Disclosure

The roughly 35-line body has two well-organized sections ("## Start here", "## Then"), no bundle files exist, and all guidance fits inline with no nested references — under the under-50-lines exception, well-organized sections alone warrant a 5.

5 / 5

Total

19

/

20

Passed

Description

78%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, third-person description that clearly answers both what and when with a natural trigger clause and no fluff. Its only weaknesses are thin action coverage (a single named action) and a few missing natural synonyms, which cap specificity and trigger quality below the top anchors.

Suggestions

Name one or two more concrete actions in the description (e.g., 'asks a short set of questions and fills a six-line FAQ frame') to lift specificity beyond a single action.

Add natural synonyms such as 'frequently asked questions' or 'common questions' to the trigger clause so it matches more phrasings a user would actually say.

DimensionReasoningScore

Specificity

"Turn repeat questions into a pinned FAQ" names the domain and exactly one concrete action, matching the anchor for 1-2 concrete actions rather than the several specific actions required for a 4 or 5.

3 / 5

Completeness

It explicitly answers both what ("Turn repeat questions into a pinned FAQ") and when ("Use when a champion keeps answering the same questions") with a concrete trigger phrase, matching the anchor-5 pattern exactly; it is not a 4 because the when-clause is already explicit and specific.

5 / 5

Trigger Term Quality

"repeat questions", "FAQ", and "keeps answering the same questions" are natural phrases a user in this situation would say, though common synonyms like "frequently asked questions" or "common questions" are absent — good coverage with a few natural terms missing, matching 4 rather than comprehensive coverage at 5.

4 / 5

Distinctiveness Conflict Risk

"pinned FAQ" combined with the champion scenario forms a clear niche with a distinct trigger, but FAQ/document creation could still overlap with general documentation or onboarding skills — mostly distinct with minor overlap risk, matching 4 rather than the minimal-conflict anchor at 5.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

anthropics/claude-plugins-official

Path

plugins/champion-kit/skills/faq/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.