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

82%

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

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

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.

An unusually actionable, tightly written instruction skill: every section gives concrete rules, exact API usage, and a complete starter template, with real error-recovery loops for saves and sharing. Its one structural weakness is that it is entirely monolithic — the large HTML/CSS template and primitives reference would score better split into one-level-deep bundle files.

Suggestions

Move the starter template HTML/CSS into a bundle file (e.g., assets/template.html or references/starter-template.md) and keep a short 'copy this file, replace ALL-CAPS placeholders' pointer in SKILL.md, cutting well over half the token load.

Consider moving the 'primitives' catalog into a references/primitives.md for on-demand lookup, keeping only the most-used primitives (finding, note, table) summarized inline.

Add a brief end-to-end sequence at the top (check list_reports → write → save_report → share if requested → three-bullet reply) so the workflow across the six sections is explicit rather than synthesized.

DimensionReasoningScore

Conciseness

The prose is dense and high-signal — rules like "A report with twenty findings has failed" and "No paragraph runs past two sentences" instruct without padding, and nothing explains concepts Claude already knows. It falls short of anchor 5 due to minor repetition (title rules restated across sections; the in-page-anchor exception to target="_blank" appears in both HTML constraints and the primitives) and long stretches of inline CSS.

4 / 5

Actionability

Fully executable throughout: exact tool calls with parameters (`list_reports`, `save_report` with `reportId`, `set_report_sharing` with `public: true`), exact title formats ("MMM D, YYYY"), byte limits ("aim under 80 KB", "hard cap is 500,000 bytes"), expected error strings ("stopped early"), and a complete copy-paste starter template covering the common case.

5 / 5

Workflow Clarity

Numbered pre-checks ("Before you write" 1-3: dedupe via list_reports, title uniqueness, when to fetch HTML), explicit post-save steps, and genuine feedback loops ("If the save fails, the error names the limit and the value. Fix that one thing and save again"; truncated HTML → do not overwrite). Not anchor 5: the end-to-end sequence must be synthesized across six separate sections rather than given as one master flow, and validation is largely delegated to the viewer/server rather than performed by the agent.

4 / 5

Progressive Disclosure

The bundle contains only SKILL.md — no references/, scripts/, or assets/ — and the ~155-line starter template with its CSS plus the primitives catalog are all inlined. Section headers are clear, but content that would naturally live one level deep (e.g., a template.html or primitives reference) is inline in the main file, matching the anchor 'content that should be separate is inline' despite good structure.

3 / 5

Total

16

/

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.

The description is a strong, well-formed example: explicit what-and-when with concrete, natural trigger phrases and a distinctive OpenSEO report niche. Its main weakness is thin action coverage — it names only writing and saving, omitting the revising, template, and sharing behaviors the body actually governs.

Suggestions

Expand the 'what' clause with one or two more concrete actions, e.g. "Write, revise, and save an OpenSEO report as one self-contained HTML page, following a project's report template when given".

Narrow the generic "summary" trigger to reduce overlap with plain summarization requests, e.g. "asks for an SEO report, check-in, or summary of finished research".

DimensionReasoningScore

Specificity

"Write and save an OpenSEO report as one self-contained HTML page" names the domain and two concrete actions (write, save), but coverage is not comprehensive — revising existing reports, applying templates, and public sharing go unmentioned. This matches the anchor 'Names domain and 1-2 concrete actions, but not comprehensive' rather than anchor 4, which expects several specific actions listed.

3 / 5

Completeness

It explicitly answers both questions: the "what" is "Write and save an OpenSEO report as one self-contained HTML page" and the "when" is a concrete 'Use when' clause with specific trigger phrases ("a skill has finished its research", "asks for a report, check-in, or summary", "names a report template"). This mirrors the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "asks for a report, check-in, or summary, or names a report template". A few natural variations are missing (e.g., "write-up", "findings", "deliverable"), so it falls short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"OpenSEO report" and "report template" carve a clear niche with mostly distinct triggers. The bare words "summary" and "check-in", however, could also match generic summarization skills, which is more than the minimal conflict risk of anchor 5 — so it sits at 'mostly distinct; minor overlap risk'.

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

.agents/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.