CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

seo-report

Write and save an OpenSEO report as one self-contained HTML page. Use when a skill has finished its research, and whenever the user asks for a report, check-in, or summary, or names a report template.

Quality

86%

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

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 unusually actionable skill: concrete tool calls, exact limits and formats, a complete copy-paste HTML template, and a clearly sequenced workflow with explicit error-recovery loops for save failures and truncated revisions. The main trade-off is size — a ~155-line inline template and detailed CSS rationale keep it efficient but not lean — and the absence of any reference-file structure leaves everything in one file.

DimensionReasoningScore

Conciseness

The prose is dense and imperative with no explanation of concepts Claude already knows — no definition of HTML, SEO, or reporting basics; every section carries operational rules ("No paragraph runs past two sentences", "Gloss every term of art on first use"). It is not a 5 because the ~155-line inline starter template with its explanatory CSS comments is a substantial token block that could be trimmed or externalized, the rubric's definition of "minor instances of over-explanation that could be trimmed".

4 / 5

Actionability

Fully executable throughout: exact tool calls and parameters ("pass its `reportId` to `save_report`", "call `set_report_sharing` with the same `projectId`"), exact limits ("The hard cap is 500,000 bytes"), exact formats ("MMM D, YYYY", "Read the full report: <url>"), and a complete copy-paste HTML starter template covering the common case. The save-failure instruction is a concrete fix-and-retry step, not vague direction.

5 / 5

Workflow Clarity

The lifecycle is clearly sequenced (pre-flight checks in "Before you write" → writing rules → title/summary → closing section → HTML constraints → sharing → post-save behavior) with explicit validation and recovery: the numbered dedup/revision checklist, the guard "if what comes back looks cut off, send the user to the app instead of saving over it", and the feedback loop "If the save fails, the error names the limit and the value. Fix that one thing and save again." This matches anchor 5's sequence-with-error-recovery pattern; anchor 4 would require missing checkpoints, and none are missing.

5 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories, and the body is well-sectioned (Goal, Before you write, Writing rules, HTML constraints, Starter template, Primitives, Guardrails) making it easy to navigate. It is not a 5 because there is no reference structure at all and the full starter template is inlined — a plausible candidate for an assets/ file — though since the template is used on every run rather than conditionally, this is a minor organization gap rather than the "content that should be separate is inline" of anchor 3.

4 / 5

Total

18

/

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, well-formed description that clearly answers both what the skill does and when to use it, with natural trigger phrasing. Its weaknesses are modest: the action list is narrow (write/save, with sharing and templating only implied), and "summary"/"check-in" as triggers are broad enough to invite some overlap with generic reporting skills.

Suggestions

Broaden the capability list beyond write/save, e.g. "Write, revise, and share OpenSEO reports as self-contained HTML pages", so specificity reflects the revise/replace and public-sharing workflows the body actually covers.

Narrow or contextualize the broad trigger words ("summary", "check-in") to the OpenSEO domain, e.g. "asks for an OpenSEO report, check-in, or summary of a finished skill run", to reduce conflict risk with generic summarization skills.

Add one or two common synonyms users might say, such as "write-up" or "findings", to strengthen trigger-term coverage.

DimensionReasoningScore

Specificity

"Write and save an OpenSEO report as one self-contained HTML page" names the domain and two concrete actions (write, save) plus a format constraint, matching "names domain and 1-2 concrete actions, but not comprehensive". It does not list several distinct actions, so it falls below anchor 4.

3 / 5

Completeness

Both parts are explicit: the "what" ("Write and save an OpenSEO report as one self-contained HTML page") and the "when" with concrete trigger phrases ("Use when a skill has finished its research, and whenever the user asks for a report, check-in, or summary, or names a report template"). This matches the anchor-5 example pattern exactly; anchor 4 would require the when-clause to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural user phrasing is present — "asks for a report, check-in, or summary, or names a report template" — giving good keyword coverage of how users would phrase the need. A few natural synonyms (e.g. "write-up", "findings", "brief") are missing, so it does not reach anchor 5's comprehensiveness.

4 / 5

Distinctiveness Conflict Risk

"OpenSEO report" carves a clear niche with distinct tooling (report templates, save_report workflow), but the trigger "whenever the user asks for a... summary" is a broad word that overlaps with general summarization skills, giving minor conflict risk. Mostly distinct rather than the minimal risk of anchor 5.

4 / 5

Total

16

/

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

plugins/openseo/skills/seo-report/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.