html-coder

Expert HTML development skill for building web pages, forms, and interactive content. Use when creating HTML documents, structuring web content, implementing semantic markup, adding forms and media, working with HTML5 APIs, or needing HTML templates, best practices, and accessibility guidance. Supports modern HTML5 standards and responsive design patterns.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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, actionable skill body with executable HTML examples, a validated artifact-publishing workflow, and clean progressive disclosure to real reference files. The main improvements are removing minor redundancy between capability and best-practice sections and adding an explicit validation retry loop.

Suggestions

Merge or differentiate 'Core Capabilities' and 'Best Practices' to remove overlapping bullet restatements.

Add an explicit 'if validation fails, fix the issue and re-validate before publishing' retry loop to the OpenSquilla delivery workflow.

Dimension	Reasoning	Score
Conciseness	Mostly lean with bullets and code blocks and no 'what is HTML' filler, but 'Core Capabilities' and 'Best Practices' partially restate each other, leaving minor redundancy that could be trimmed.	4 / 5
Actionability	Provides three complete, copy-paste-ready HTML examples (semantic page, accessible form, responsive image) plus a concrete JSON publish_artifact payload, covering the common cases.	5 / 5
Workflow Clarity	The OpenSquilla delivery flow is numbered 1-3 with an explicit validation checkpoint ('Validate the finished project, then call publish_artifact') and a conditional caller-contract branch, but lacks an explicit validate->fix->retry error-recovery loop.	4 / 5
Progressive Disclosure	Clear overview with well-signaled one-level-deep references (all 7 referenced files exist and each has a one-line description), and detailed reference content is appropriately split out of SKILL.md.	5 / 5
	Total	18 / 20 Passed

Description

88%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, specific description that names concrete HTML actions and provides explicit 'Use when' trigger guidance covering many natural user phrases. It could improve slightly by adding file extensions and tightening distinctiveness against closely related frontend skills.

Suggestions

Add natural file-extension triggers like '.html' or '.htm' to round out trigger term coverage.

Sharpen distinctiveness by contrasting with CSS/JS skills (e.g., scope to markup/structure only) to reduce overlap with adjacent frontend skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions such as 'building web pages, forms, and interactive content', 'creating HTML documents, structuring web content, implementing semantic markup, adding forms and media, working with HTML5 APIs', giving comprehensive coverage of capabilities.	5 / 5
Completeness	Clearly answers 'what' ('building web pages, forms, and interactive content') and explicitly answers 'when' with concrete trigger phrases ('Use when creating HTML documents, structuring web content, implementing semantic markup...').	5 / 5
Trigger Term Quality	Natural terms users would say are present ('web pages', 'forms', 'HTML documents', 'HTML templates', 'responsive design') with good synonym coverage, but file extensions like '.html' or '.htm' are missing, keeping it just below comprehensive.	4 / 5
Distinctiveness Conflict Risk	Scoped to HTML with distinct HTML5 and accessibility triggers, but 'HTML' is broad enough to overlap with adjacent CSS or general frontend skills, leaving minor conflict risk.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: TokenRhythm/opensquilla
Path: src/opensquilla/skills/bundled/html-coder/SKILL.md
Commit: 94ac35e

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

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.