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.

71

Quality

89%

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.

The body is an excellent overview: it front-loads high-value EmDash-specific gotchas, provides executable code for the common cases, and defers bulk detail to four real, well-organized reference files. The only improvements are minor — trimming the duplicated reference listing and adding brief error-recovery guidance for common failure modes.

DimensionReasoningScore

Conciseness

The body is lean and EmDash-specific throughout — gotchas, file structure, and an API cheat sheet — with no explanation of concepts Claude already knows. The one trimmable redundancy is the Reference Documents table, which repeats the per-step reference pointers and content summaries already given in the Workflow section, keeping it just below the every-token-earns-its-place 5-anchor.

4 / 5

Actionability

The Quick API Cheat Sheet provides copy-paste-ready TypeScript (full import lists for "emdash", "emdash/ui", comments, search, and page context, plus a real getEmDashCollection call with options), the gotchas give exact corrective code (<Image image={...} /> from "emdash/ui", getTerm("category", slug)), and concrete commands (pnpm dev) and config (plugin registration) are included. This matches the fully-executable, common-cases-covered top anchor; there are no meaningful gaps that would drop it to 4.

5 / 5

Workflow Clarity

Six numbered steps in dependency order each map to a specific reference document, and step 6 ("Run and verify") includes the dev command plus expected first-request behavior (migrations, seed application, generated types, admin URL). There is no explicit error-recovery loop (e.g., what to check when a page renders empty), so it does not reach the 5-anchor; the verify checkpoint and clear sequence keep it above the 3-anchor, and no destructive/batch operation lacks validation.

4 / 5

Progressive Disclosure

A clear ~150-line overview points to four well-signaled, one-level-deep reference files that all exist and are substantial (234-540 lines), referenced both via bold links in the workflow steps and a summary table; plugin detail is delegated to a separate skill and the references contain no nested .md references. This matches the clear-overview, well-signaled, easy-navigation top anchor.

5 / 5

Total

18

/

20

Passed

Description

87%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 capabilities, gives an explicit and domain-specific "Use for" trigger, and proactively disambiguates against the sibling plugin-authoring skill. The only weakness is that capabilities are listed as objects of one verb rather than as distinct actions, which slightly limits specificity.

DimensionReasoningScore

Specificity

The description enumerates seven-plus concrete capability areas ("schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration"), but they are noun-phrase objects of the single verb "Build" rather than the multiple distinct action verbs of the top anchor. It is well above the 3-anchor, which covers only 1-2 concrete actions.

4 / 5

Completeness

It explicitly answers both what ("Build the site-facing parts of an EmDash CMS project on Astro, including...") and when ("Use for EmDash site and theme work"), with concrete trigger phrases and an additional negative trigger ("use creating-plugins instead when the task is plugin authoring alone"). The when-clause is specific and disambiguating, exceeding the 4-anchor where the when "could be more explicit".

5 / 5

Trigger Term Quality

"EmDash CMS", "Astro", "site and theme work", "taxonomies", "widgets", and "Portable Text" are natural terms a user would say when needing this skill. A few natural variations (e.g., "website", "theme development") are missing, keeping it just below the comprehensive 5-anchor.

4 / 5

Distinctiveness Conflict Risk

"EmDash" names a specific CMS niche, and the only likely skill overlap (plugin authoring) is explicitly resolved by "use creating-plugins instead when the task is plugin authoring alone". This matches the clear-niche, minimal-conflict top anchor rather than the 4-anchor's unaddressed minor overlap.

5 / 5

Total

18

/

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