CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

building-emdash-site

Build the site-facing parts of an EmDash CMS project on Astro, including schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration. Use for EmDash site and theme work; use creating-plugins instead when the task is plugin authoring alone.

72

Quality

91%

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 building-emdash-site in emdash-cms/emdash

SKILL.md
Quality
Evals
Security

Quality

Content

86%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, highly actionable skill body: product-specific gotches, executable code and commands, and clean one-level reference delegation. The main improvement opportunities are removing the duplicated reference table and adding explicit verification checkpoints to the final workflow step.

Suggestions

Drop the closing "Reference Documents" table (or fold its two-line scope summaries into the Workflow step pointers) — the same four links are already given in context, so the table is duplicate navigation.

Strengthen step 6 with an explicit verification loop, e.g. "open http://localhost:4321/<collection> and confirm entries render; if empty, check the taxonomy name matches the seed exactly" — reusing the gotchas as failure diagnostics.

Show one-line usage for the highest-traffic site-feature helpers (e.g. getMenu, getWidgetArea) alongside their imports so the cheat sheet needs no reference hop for the most common calls.

DimensionReasoningScore

Conciseness

The body is efficient: the gotchas are non-obvious, product-specific failure modes; the intro conveys only EmDash facts Claude cannot know; the workflow steps are one-line pointers. Minor trimmable instances remain — the closing Reference Documents table duplicates the four reference links already given in the Workflow section, and the Plugins "consider a plugin when" bullets are partly descriptive routing. This sits between the 4 anchor (efficient, minor over-explanation) and 5 (every token earns its place); the duplicated navigation keeps it at 4.

4 / 5

Actionability

Guidance is copy-paste ready throughout: exact calls ("getTerm(\"category\", slug)", "Astro.cache.set(cacheHint)"), executable config ("output: \"server\" in astro.config.mjs"), a complete destructured query example, the plugin registration snippet, and the concrete command "pnpm dev" plus the admin URL. The common cases (query a collection, render an entry, image handling) are covered specifically; this matches the 5 anchor rather than 4 ("minor gaps").

5 / 5

Workflow Clarity

A clear 6-step sequence (configure → schema → pages → features → seed → run/verify) with the verify step giving concrete startup observables (migrations run, types generated, admin at "http://localhost:4321/_emdash/admin"). It stops short of the 5 anchor's explicit validation steps and error-recovery loops — there is no "check the page renders / fix and retry" checkpoint — but no destructive/batch cap applies, so 4 fits.

4 / 5

Progressive Disclosure

The body is a genuine overview: four one-level-deep references (all verified present on disk), each signaled twice with scope descriptions in the Workflow steps, plugin detail delegated to a separate skill, and only a right-sized cheat sheet inline. This matches the 5 anchor (clear overview, well-signaled one-level-deep references, easy navigation).

5 / 5

Total

18

/

20

Passed

Description

92%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 states concrete, domain-specific capabilities, gives an explicit use trigger, and proactively disambiguates from the related plugin-authoring skill. The only minor gap is a few natural trigger-term variations beyond the product-specific vocabulary.

DimensionReasoningScore

Specificity

The description enumerates comprehensive, concrete capability areas: "schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration" — all specific to the EmDash/Astro domain. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); the 4 anchor ("minor gaps in coverage") fits worse since no significant site-building area is omitted.

5 / 5

Completeness

Both parts are explicit: "what" is the enumerated build capabilities, and "when" is the concrete trigger clause "Use for EmDash site and theme work" — additionally sharpened by disambiguation ("use creating-plugins instead when the task is plugin authoring alone"). This clearly matches the 5 anchor; the 4 anchor ("when could be more explicit") is too weak a fit.

5 / 5

Trigger Term Quality

Good keyword coverage with natural, product-specific terms users would say: "EmDash CMS", "Astro", "site", "theme", "schema", "taxonomies", "Portable Text". A few natural trigger variations are absent (e.g., "content rendering", "build a site with EmDash", file paths), matching the 4 anchor ("good keyword coverage; a few natural terms missing") rather than the 5 anchor's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

A clear niche (a specific named CMS product) with distinct triggers and an explicit routing clause away from the sibling creating-plugins skill, giving minimal conflict risk. Voice is third person ("Build..."), so no voice penalty applies.

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

emdash-cms/emdash

Path

templates/blog-cloudflare/.agents/skills/building-emdash-site/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.