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.

77

Quality

97%

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

93%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 tightly written overview that front-loads the silent failure modes Claude could never infer, delegates detail to four well-organized one-level-deep references, and provides copy-paste-ready API usage. The only weakness is that the final 'Run and verify' step stops short of explicit validation checkpoints.

DimensionReasoningScore

Conciseness

Every section carries non-inferable proprietary knowledge — the five gotchas (image fields are objects, entry.id vs entry.data.id, taxonomy name matching, cache hints, no getStaticPaths), the file tree, and the API cheat sheet. Nothing explains concepts Claude already knows (no "what is a CMS/Astro" padding), fitting the 5-anchor 'every token earns its place'; the 4-anchor would require over-explanation to trim, which is absent.

5 / 5

Actionability

The Quick API Cheat Sheet is copy-paste-ready TypeScript with real imports and signatures, the gotchas show the exact correct usage (`<Image image={post.data.featured_image} />`, `getTerm("category", slug)`), and commands like `pnpm dev` are concrete. Matches the 5-anchor 'fully executable, specific examples cover the common cases'.

5 / 5

Workflow Clarity

The six-step workflow (configure → schema → pages → features → seed → run and verify) is clearly sequenced with each step pointing to a specific reference, but step 6 offers no explicit validation checkpoints (e.g., confirm pages render, verify the admin UI loads) — it only describes runtime behavior. Fits the 4-anchor 'clear sequence with most checkpoints present; minor validation gaps'; the 5-anchor requires explicit validation steps with feedback loops. No destructive/batch cap applies.

4 / 5

Progressive Disclosure

The body is a lean overview with four real, one-level-deep reference files (configuration.md, schema-and-seed.md, querying-and-rendering.md, site-features.md — all verified present), each well-signaled in the workflow with a summary of its contents and recapitulated in a navigation table. Content is appropriately split and easy to navigate, matching the 5-anchor exactly.

5 / 5

Total

19

/

20

Passed

Description

100%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.

An exemplary description: concrete and comprehensive in what it builds, explicit about when to use it, and it even disambiguates against the sibling creating-plugins skill. Third-person voice, no fluff, every term is a natural trigger.

DimensionReasoningScore

Specificity

"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" lists seven concrete deliverables with comprehensive coverage of the skill's scope. This matches the 5-anchor (multiple specific concrete actions, comprehensive); the 4-anchor requires minor coverage gaps, which are absent here.

5 / 5

Completeness

Explicitly answers both: what ("Build the site-facing parts... including schema and seeds, content queries, Portable Text rendering, menus, taxonomies, widgets, and deployment configuration") and when ("Use for EmDash site and theme work"), with concrete trigger phrases. Matches the 5-anchor exactly; the 4-anchor requires the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural terms include "EmDash", "CMS", "Astro", "site", "theme", and "plugins" — exactly what a user would say when needing this skill (e.g., "build my EmDash site", "EmDash theme work"). The domain has no file extensions to include, and no common synonyms are missing, so this fits the 5-anchor rather than the 4-anchor's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

Clear niche (EmDash site/theme building on Astro) with distinct triggers, and it actively prevents mis-triggering with "use creating-plugins instead when the task is plugin authoring alone". Minimal conflict risk, matching the 5-anchor; the 4-anchor's 'minor overlap risk with closely related skills' is explicitly addressed by the boundary clause.

5 / 5

Total

20

/

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