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-engineered skill body: concrete gotchas, executable API examples, and a clean workflow that pushes detail into four substantial reference files one level deep. The only improvements are trimming the doubled reference listing and adding an explicit troubleshooting checkpoint to the run-and-verify step.

DimensionReasoningScore

Conciseness

The body is dense and earns its tokens: five concrete gotchas, a file-structure map, and an API cheat sheet with no generic Astro/programming filler. It is not a 5 because there is minor redundancy — the four reference files are described twice (inline in the Workflow steps and again in the Reference Documents table) — and the intro sentence about what EmDash is could be one clause shorter.

4 / 5

Actionability

Guidance is copy-paste ready: exact import paths ('emdash/ui', 'emdash/ui/comments'), executable query snippets (getEmDashCollection with limit/cursor/orderBy), concrete commands ('pnpm dev'), and gotchas stated as wrong-vs-right pairs ('Writing <img src={post.data.featured_image} /> renders [object Object]'). This matches anchor 5 — specific examples cover the common cases — rather than anchor 4, which allows missing key details.

5 / 5

Workflow Clarity

A clear six-step sequence (configure → schema → pages → site features → seed → run and verify) with a final verification step that states expected behavior (migrations on first request, seed application, admin URL). It is not a 5 because there are no explicit error-recovery checkpoints (e.g., what to check when a page renders empty, echoing gotcha #3's silent empty results); it is above a 3 because a verify step with expected outcomes is present and no destructive/batch operation lacks validation.

4 / 5

Progressive Disclosure

SKILL.md is a genuine overview and all detail lives one level deep in four real, substantial reference files (234–540 lines each, verified present), each clearly signaled in the workflow with what it covers. This matches anchor 5's 'well-signaled one-level-deep references; content appropriately split; easy navigation' — no nesting and no reference-worthy content inlined.

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: third-person voice, enumerates concrete capabilities, and answers both what and when explicitly, with a clear disambiguation boundary against the plugin-authoring skill. Only slight room for improvement in natural trigger phrasing variants.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration' — giving comprehensive coverage of the skill's scope, matching the anchor-5 example's enumeration of specific capabilities. It does not fit anchor 4, which requires minor gaps in coverage; every workflow step in the body maps to an item named here.

5 / 5

Completeness

It explicitly answers both questions: what ('Build the site-facing parts of an EmDash CMS project on Astro, including...') and when ('Use for EmDash site and theme work'), matching the anchor-5 pattern of a concrete what followed by an explicit 'Use when' clause. It is not a 4 because the trigger guidance is fully explicit, even adding a negative boundary ('use creating-plugins instead when the task is plugin authoring alone').

5 / 5

Trigger Term Quality

Good keyword coverage including the natural terms a user would say: 'EmDash CMS', 'Astro', 'site', 'theme', plus the 'creating-plugins' disambiguator. It sits between anchor 3 (missing common variations) and anchor 5 (comprehensive synonyms/extensions); a few natural phrasings users might use (e.g., 'content modeling', 'build a site with EmDash') are absent, so it fits anchor 4's 'a few natural terms missing' better than 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche ('EmDash CMS project on Astro') with distinct triggers and an explicit pointer to the sibling creating-plugins skill, which actively prevents mis-triggering on plugin-authoring tasks. This is minimal conflict risk, matching anchor 5 rather than anchor 4's 'minor overlap risk' — no other generic skill would claim these triggers.

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