CtrlK
BlogDocsLog inGet started
Tessl Logo

seo

SEO best practices for the Grida project across Next.js pages, blog posts, and documentation. Covers Next.js metadata API, Open Graph / Twitter cards, sitemaps, image search optimization, structured data (JSON-LD), Docusaurus frontmatter, and content writing for search. Use when creating or editing public-facing pages under editor/app/(www), writing blog posts, authoring docs, or reviewing SEO-related metadata. Trigger phrases: "SEO", "metadata", "sitemap", "open graph", "og image", "meta tags", "search ranking", "structured data", "JSON-LD".

68

Quality

81%

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

67%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 well-structured, largely actionable project skill: concrete code, specific paths, project-specific gotchas (metadataBase gap, sitemap auto-discovery, tenant-domain canonicals), and a closing verification checklist. The main deductions are the eight-item general-writing section that re-teaches SEO knowledge Claude already has, and the truncated dynamic-metadata / missing JSON-LD examples.

Suggestions

Cut or drastically shrink "General SEO Writing Rules" — keep only the non-obvious items (one primary keyword per page, unique title/description) and drop what Claude already knows (alt text, mobile-first, descriptive link text, URL hygiene).

Complete the `generateMetadata` example or remove it, and add a minimal JSON-LD `<script type="application/ld+json">` embed example alongside the schema-type list.

Consider moving the Google Image Search checklist and blog-post guidelines into one-level-deep reference files to slim the main SKILL.md toward an overview.

DimensionReasoningScore

Conciseness

The project-specific sections are appropriately lean (e.g. the `metadataBase` gap, per-route-group sitemap discovery, `robots.txt` location), but "General SEO Writing Rules" spends eight numbered items on things Claude already knows — "Write for humans first", "Descriptive link text... not 'click here'", "Alt text on images", "Mobile-first... Google uses mobile-first indexing", "Keep URLs short, lowercase, hyphenated". This fits the level-3 anchor (mostly efficient but includes some unnecessary explanation) better than level 4, where over-explanation would be only minor.

3 / 5

Actionability

Most guidance is executable: a copy-paste-ready static `metadata` export, a concrete `metadataBase` value, a sitemap entry object, a doc frontmatter block, and good/bad title examples ("How Grida Canvas Renders 10K Nodes at 60 FPS" vs "Exciting Updates!"). Minor gaps keep it below 5: the dynamic example is truncated pseudocode (`generateMetadata({ params }): Promise<Metadata> { ... }`) and the JSON-LD section names schema types without any embed example.

4 / 5

Workflow Clarity

The body is organized per-surface (Next.js pages → docs → blog → crawl control → general rules) and closes with an explicit "Verification Checklist" ("Before shipping a public page or post: title/description set, description under 160 chars and unique, OG image absolute and returns 200..."), which serves as a validation checkpoint. It is not 5 because there is no feedback loop (check → fix → re-check) and no ordered pre-ship sequence — sections are parallel guidance rather than a sequenced workflow with error-recovery steps; it is not 3 because the checklist makes validation explicit rather than merely implied.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/ directories), so all content lives in this one file; the ~240 lines are broken into well-labeled sections (Scope table, per-surface sections, Known Gaps, checklist) that are easy to navigate. It is not 5 because the file exceeds the simple-skill threshold and some content (the Google Image Search checklist and the blog guidelines) could plausibly be split into one-level-deep reference files; it is not 3 because what is inline is appropriately sectioned and nothing is buried.

4 / 5

Total

15

/

20

Passed

Description

96%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 a clear niche, enumerates comprehensive concrete capabilities, and provides an explicit 'Use when' clause with natural trigger phrases. Its only weakness is that broadly-worded triggers like "metadata" and "meta tags" have some overlap risk with non-SEO metadata tasks.

Suggestions

Qualify the generic trigger terms, e.g. "meta tags" / "page metadata" instead of bare "metadata", to reduce overlap with non-SEO metadata work.

Optionally append the surface scope to the trigger list (e.g. "when touching editor/app/(www) or docs/** pages") so it fires only on the pages it actually governs.

DimensionReasoningScore

Specificity

The description lists many concrete, specific items: "Next.js metadata API, Open Graph / Twitter cards, sitemaps, image search optimization, structured data (JSON-LD), Docusaurus frontmatter, and content writing for search" plus concrete actions ("creating or editing public-facing pages under editor/app/(www), writing blog posts, authoring docs, or reviewing SEO-related metadata"). Coverage is comprehensive across all project surfaces, matching the level-5 anchor; nothing significant is missing for the stated scope.

5 / 5

Completeness

It explicitly answers both questions: "what" via "Covers Next.js metadata API, ... structured data (JSON-LD), Docusaurus frontmatter, and content writing for search" and "when" via "Use when creating or editing public-facing pages..., writing blog posts, authoring docs, or reviewing SEO-related metadata" plus concrete trigger phrases. This matches the level-5 anchor exactly; it is not level 4 because the 'when' clause is fully explicit with enumerated triggers.

5 / 5

Trigger Term Quality

Trigger phrases are enumerated explicitly — "SEO", "metadata", "sitemap", "open graph", "og image", "meta tags", "search ranking", "structured data", "JSON-LD" — covering natural phrasings, abbreviations, and synonyms a user would actually say. This matches the level-5 anchor (comprehensive natural terms including synonyms); the only marginally absent variants (e.g., "google", "rich results") are obscure relative to what's listed.

5 / 5

Distinctiveness Conflict Risk

The skill is clearly distinguishable via project-scoped specifics ("Grida project", "editor/app/(www)", Docusaurus, JSON-LD), but generic trigger terms like "metadata" and "meta tags" could fire for unrelated metadata work (e.g., database or API metadata tasks), creating minor overlap risk. This fits the level-4 anchor (mostly distinct; minor overlap risk) rather than 5, whose niche triggers are all but unambiguous.

4 / 5

Total

19

/

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
gridaco/grida
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.