CtrlK
BlogDocsLog inGet started
Tessl Logo

faq

Use when adding FAQ sections to landing pages or blog posts, generating FAQPage JSON-LD from existing Q&A content, or validating that structured data on pages with FAQ sections is syntactically and semantically correct.

68

Quality

83%

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

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 tight, actionable overview: complete JSON-LD example, concrete validation steps, and a correctly structured one-level reference. Its main flaw is redundancy — the rationale appears twice (intro and Explain) and the validation criteria are listed twice (Check and Code Review) — which inflates token cost without adding guidance.

Suggestions

Merge the "Explain" section into the intro (or vice versa) — both state that FAQPage rich results expand SERP footprint and improve CTR, so keep only one.

Consolidate "Check" and "Code Review", which enumerate the same validation criteria (mainEntity array, Question objects, name, acceptedAnswer/Answer/text, match against visible content); a single validation checklist section would remove the duplication.

Add a brief error-recovery step after the Rich Results Test validation (e.g., "if errors are reported, fix the flagged fields and re-run the test") to close the feedback loop.

DimensionReasoningScore

Conciseness

Mostly efficient, but with noticeable redundancy: the intro paragraph and the "Explain" section repeat the same rich-results/CTR rationale almost verbatim, and "Check" items (1)-(4) restate the same validation criteria as the "Code Review" section. This is more than the minor trimmable instances of the anchor 4 example, matching the "could be tightened" anchor 3.

3 / 5

Actionability

The Fix section provides a complete, valid, copy-paste-ready FAQPage JSON-LD block, a concrete validation tool URL (Google's Rich Results Test), and unambiguous field-level requirements ("acceptedAnswer" with "@type": "Answer" and "text"). The Check/Code Review steps give specific executable criteria covering the common cases.

5 / 5

Workflow Clarity

A clear Check → Fix → Code Review sequence with an explicit validation checkpoint ("Validate the markup using Google's Rich Results Test" and cross-referencing schema against visible page content). It stops short of anchor 5 because there is no explicit error-recovery feedback loop (what to do when the Rich Results Test reports errors, beyond the general fix steps).

4 / 5

Progressive Disclosure

The ~50-line body is a well-organized overview (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists and is on-topic (verified: it contains the same rule with good/bad code examples). No buried or nested references.

5 / 5

Total

17

/

20

Passed

Description

88%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 strong description: it names the domain, three concrete capabilities, and explicit trigger situations in third person with no fluff. Its only weaknesses are a couple of missing natural synonyms ("FAQ schema", "rich results") and a first clause that risks over-triggering for general FAQ content authoring.

DimensionReasoningScore

Specificity

The description lists three concrete, distinct actions — "adding FAQ sections to landing pages or blog posts", "generating FAQPage JSON-LD from existing Q&A content", and "validating that structured data on pages with FAQ sections is syntactically and semantically correct" — which comprehensively covers the skill's scope. It matches the anchor for multiple specific concrete actions rather than the anchor 4 example with only minor gaps.

5 / 5

Completeness

Both what and when are explicitly answered: the "Use when..." clause gives explicit trigger guidance, and the three gerund actions state exactly what the skill does, with concrete trigger phrases. It is not the anchor 4 case where the 'when' is weakly specified — the triggers name specific situations (adding FAQ sections, generating JSON-LD, validating structured data).

5 / 5

Trigger Term Quality

Good keyword coverage: "FAQ sections", "FAQPage", "JSON-LD", "structured data", "Q&A content", "landing pages", "blog posts" — all phrases a user would naturally say. A few natural variants are missing (e.g., "FAQ schema", "rich results", "schema markup"), so it falls just short of the comprehensive-synonym anchor 5.

4 / 5

Distinctiveness Conflict Risk

The FAQPage/FAQ-section niche is clear and mostly distinct from other SEO or schema skills, but the trigger "adding FAQ sections to landing pages or blog posts" could also fire for plain FAQ copy-writing requests that this schema-markup skill does not actually cover — a minor overlap risk consistent with the "mostly distinct" anchor.

4 / 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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.