CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-project-setup

Populate a project's shared OpenSEO context — site scope, goals, positioning, competitors, key pages, and preferences — plus MCP checks and Search Console intake.

65

Quality

82%

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

The canonical home for this skill is seo-project-setup in every-app/open-seo

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.

A highly actionable, well-sequenced interview workflow: concrete MCP tool schemas, explicit ordering, validation checkpoints, and guardrails against unverified claims. The only notable gaps are minor trimmable rationale sentences and no use of external reference files for the more reference-like detail (patch-op schema, GSC export naming).

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — checklists, tool signatures, and guardrails with almost no concept explanations Claude already knows. A few rationale sentences ("GSC is the richest first-party signal: existing impressions, near-ranking terms, cannibalization..." and "so it survives new sessions, new machines, and new agents") could be trimmed, which keeps it at anchor 4 rather than anchor 5's "every token earns its place".

4 / 5

Actionability

Guidance is fully executable for an instruction-only skill: exact tool signatures (`get_project_context(projectId)`, `update_project_context(projectId, updates)`), copy-paste-ready patch-op shapes ({ section: ..., content }, { addCompetitors: [...] }), concrete GSC export filenames (gsc/queries-last-3-months.csv), a defined output table, and specific examples like "rank top 10 for 20 buying-intent terms". It matches anchor 5's "specific examples cover the common cases".

5 / 5

Workflow Clarity

Ten explicitly sequenced steps with ordering rationale ("Writes need a projectId, so do this first") and explicit validation checkpoints: read existing context before writing, "Confirm or correct existing entries rather than re-asking", "do not claim Search Console is connected unless get_search_console_performance confirms it", and merge-instead-of-overwrite recovery guidance. This matches anchor 5's clear sequence with validation and error-recovery loops.

5 / 5

Progressive Disclosure

The skill is a single well-organized file with no bundle files and no nested references; section headers make navigation easy. It sits at anchor 4 ("most content is appropriately placed; minor organization gaps") rather than 5 because some detail — the update_project_context patch-op schema and the GSC export naming conventions — could arguably live in a one-level-deep reference file, and the simple-skill exception (under 50 lines) does not apply to this ~190-line body.

4 / 5

Total

18

/

20

Passed

Description

66%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 specific, third-person description that clearly names the domain and the concrete artifacts it populates, with good natural keyword coverage. Its main weakness is the absence of any "Use when..." trigger clause, which both caps completeness at 3 and slightly weakens distinctiveness from related OpenSEO skills.

Suggestions

Append an explicit trigger clause, e.g. "Use when setting up or onboarding a new SEO project in OpenSEO, or when project context is missing or stale."

Include the standalone natural terms users would say — "SEO", "setup", "onboarding" — to broaden trigger coverage.

Clarify "MCP checks" into a concrete action such as "verify the OpenSEO MCP connection and resolve the project".

DimensionReasoningScore

Specificity

The description lists several specific, concrete items — "site scope, goals, positioning, competitors, key pages, and preferences" plus "MCP checks and Search Console intake" — under the concrete action "Populate a project's shared OpenSEO context". It falls short of the 5 anchor because the items are nouns rather than multiple concrete actions and phrases like "MCP checks" are slightly underspecified; it is clearly above anchor 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

The "what" is clear and detailed (populate shared OpenSEO context with the enumerated sections, plus MCP checks and Search Console intake), but there is no "Use when..." clause or equivalent explicit trigger guidance anywhere in the description. Per the judging guidelines, a missing "Use when" clause caps completeness at 3; it is not a 2 because the "what" is specific rather than vague.

3 / 5

Trigger Term Quality

Natural terms a user would say are present: "goals", "competitors", "positioning", "Search Console", "site scope". A few natural terms are missing — standalone "SEO", "setup", "onboarding" — so it does not reach the comprehensive synonym coverage of anchor 5, but it is noticeably above anchor 3's "missing common variations" bar.

4 / 5

Distinctiveness Conflict Risk

"OpenSEO" and "Search Console intake" carve a clear niche (project-context setup) distinct from related research skills like keyword-research or seo-audit. Minor overlap risk remains because the description lacks a "when" clause and could fire for generic competitor- or Search Console-related requests, so it does not reach anchor 5's "clear niche with distinct triggers".

4 / 5

Total

15

/

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

every-app/open-seo

Path

.agents/skills/seo-project-setup/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.