CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-site

Creates a new Power Pages site from an SPA or non-SPA template, or scaffolds an SPA from scratch using React, Angular, Vue, or Astro. Guides requirements discovery, template selection, provisioning, design, validation, and deployment. Use when the user wants to create, build, use a template for, or scaffold a new Power Pages website or portal.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/power-pages/skills/create-site/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 exceptionally actionable and rich in explicit validation gates, feedback loops, and checklists — a model for error-recovery guidance. Its weaknesses are token efficiency (massive verbatim repetition and inlined reference-scale content in a ~158KB file that is re-sent every turn) and progressive disclosure, where the actual bundle does not contain most referenced files and the one present reference is a redirect stub. The Phase 1.5 outline also has a duplicate step number that breaks an otherwise clear sequence.

Suggestions

Replace the 5+ verbatim repeats of the telemetry command block (and its repeated --audience/no-user-data caveats) and the 7+ repeats of the 'do not emit template_import_failure because no import was attempted' note with one canonical block or a short pointer to the approval-gates reference.

Extract the ~120-line PLAN_LABELS dictionary and the Live Preview Status Protocol section into dedicated reference files, keeping only the field contract and update triggers in SKILL.md, and ensure every referenced path (page-blueprints.md, design-critique.md, bidirectional-design.md, the ${PLUGIN_ROOT}/scripts/* helpers) actually exists in the bundle rather than relying on redirect stubs.

Fix the Phase 1.5 outline numbering — two different steps are both labeled '8' (template path and from-scratch path) and nested sub-lists restart at inconsistent depths — so the sequence reads unambiguously.

DimensionReasoningScore

Conciseness

The body is ~2,200 lines / ~158KB, with substantial padding: the telemetry command block and its "--audience is the site audience captured in Phase 1... Do not include site name, URL..." caveat are repeated near-verbatim 5+ times, "Do not emit template_import_failure because no import was attempted; template_used was already emitted" appears 7+ times, and the ~120-line PLAN_LABELS dictionary is fully inlined. This matches anchor 2 ("noticeably verbose; several unnecessary explanations or padded sections") — it is beyond anchor 3's "some unnecessary explanation" in scale, though not anchor 1 since it rarely explains concepts Claude already knows.

2 / 5

Actionability

Fully executable throughout: exact bash invocations with every flag (e.g., `node "${PLUGIN_ROOT}/scripts/fetch-template-variant.js" --sha ... --variant ...`), concrete JSON file shapes for scaffold-status.json, exit-code semantics ("Treat exit code 2 as blocking", "exits 1 when blocking rendered findings exist; parse stdout on that expected path"), per-framework marker-syntax tables, and exact AskUserQuestion tables. This matches anchor 5 ("fully executable; copy-paste ready... specific examples cover the common cases"); anchor 4 would imply minor executable gaps that are not evident.

5 / 5

Workflow Clarity

The phase sequence (1 → 8) is explicit with abundant validation checkpoints, gates, and feedback loops ("rerun the command until it passes", critique rounds capped at three with a user gate, re-run axe after fixes), matching anchor 5's substance. However, the Phase 1.5 outline is genuinely hard to follow: two different top-level steps are both numbered "8" ("8. For the template path only" and "8. For the from-scratch path only") and nested sub-lists restart numbering at inconsistent depths, which is a sequencing defect anchor 5's "clear sequence" does not permit — hence 4 rather than 5, while clearly above anchor 3's "checkpoints missing or implicit" since checkpoints are explicit everywhere.

4 / 5

Progressive Disclosure

References are clearly signaled at point of use (design-aesthetics.md, page-blueprints.md, design-critique.md, non-spa-site.md), giving real structure. But scored against the actual bundle: most referenced files (page-blueprints.md, design-critique.md, bidirectional-design.md, rendered-bidirectional-verification.md, approval-gates.md, and nearly all ${PLUGIN_ROOT}/scripts) are absent, the one present reference (design-aesthetics.md) is a 5-line redirect stub chaining two directories up, and large content that belongs in references (PLAN_LABELS dictionary, Live Preview Status Protocol) is inlined. This sits between anchor 2 (content clearly belonging in separate files inlined) and anchor 3 (some structure, references present but organization could improve), slightly above the midpoint of that pair — 3.

3 / 5

Total

14

/

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: concrete, third-person, covers both template and from-scratch paths with all supported frameworks, and closes with an explicit, verb-rich "Use when" trigger clause naming the product (Power Pages) and both "website" and "portal". Only minor headroom exists in trigger synonym coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions with comprehensive coverage of the domain: "Creates a new Power Pages site from an SPA or non-SPA template, or scaffolds an SPA from scratch using React, Angular, Vue, or Astro" plus "Guides requirements discovery, template selection, provisioning, design, validation, and deployment" — both creation modes, all four frameworks, and the full lifecycle. It fits the 5 anchor ("multiple specific concrete actions; comprehensive coverage") better than 4, which implies notable coverage gaps; none are apparent for this skill's scope.

5 / 5

Completeness

Explicitly answers both questions: the "what" is concrete site creation from templates or from scratch, and the "when" is a literal "Use when the user wants to create, build, use a template for, or scaffold a new Power Pages website or portal" with concrete trigger phrases. This matches the 5 anchor exactly; 4 would require the "when" to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Good natural-verb coverage in "Use when the user wants to create, build, use a template for, or scaffold a new Power Pages website or portal", with both "website" and "portal" as nouns. A few natural phrasings users might say are missing (e.g., "set up", "make", "launch a new site"), so it sits between the 4 anchor ("good keyword coverage; a few natural terms missing") and 5 (comprehensive synonyms), closer to 4.

4 / 5

Distinctiveness Conflict Risk

"Power Pages" names a specific product and the triggers are creation-specific ("create... or scaffold a new Power Pages website or portal"), a clear niche distinct from sibling skills like deploy, edit, or activate. Risk is limited to closely related same-plugin skills, matching the 5 anchor ("clear niche with distinct triggers; minimal conflict risk").

5 / 5

Total

19

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (2207 lines); consider splitting into references/ and linking

Warning

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository

microsoft/power-platform-skills

Path

plugins/power-pages/skills/create-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.