CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

beautiful-article

把用户提供的素材(网页 URL / PDF / DOCX / Markdown / 纯文本 / 截图 / 粘贴材料)编辑、设计成一篇美丽的、可离线打开和分享的**单文件 HTML 网页文章**。基于 reacticle 组件协议:不手写裸 HTML/CSS,而用语义组件 + 受主题约束的 Raw 自由层;按 source→规划→双确认→生成→终审→修复的小型 harness 流程推进,默认 100% 信息保留的长文。触发场景:把 URL/PDF/DOCX/文章做成网页文章 / 长文 / briefing / 解释文 / 视觉文章 / 教程 / 审阅复盘 / 方案分析,'render this as a beautiful web article / 把这篇做成网页文章 / 生成一篇可分享的 HTML 长文 / reacticle 文章'。只生成文章,不生成后台、表单、dashboard、产品原型或通用 Web App。

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 engineered 8-phase workflow skill with outstanding sequencing, hard checkpoints, per-node QA protocol, and phase-indexed progressive disclosure. Its two real weaknesses are the missing theme-profiles/ bundle directory (which breaks both the Checkpoint 1 theme step and the scaffold.sh entry command as shipped) and systematic restatement of the decision-collection/QA rules across four sections.

Suggestions

Ship the missing theme-profiles/ bundle (index.json + per-theme <id>.md): it is referenced in the Checkpoint 1 decision table ('读 theme-profiles/index.json'), the Phase 2 reading guide, the resources table, and throughout references/, and scripts/scaffold.sh hard-fails without it (theme_exists greps $SKILL_DIR/theme-profiles/index.json), so the default 'scaffold.sh ./my-article --theme=<id>' command aborts as bundled.

De-duplicate the decision-collection iron rule: it is stated in full in 硬性质检协议 (rule 5), restated in Phase 3, re-referenced in Checkpoint 2, and recapped in 默认策略 — keep one canonical statement and cross-reference it from the other locations.

Trim the cover / PDF / language-policy recaps that repeat nearly verbatim between the phase sections (Phase 1, Phase 4, Phase 8) and the 默认策略 section.

DimensionReasoningScore

Conciseness

Per-line density is high — aggressive use of tables, no explanation of concepts Claude already knows — but core rules are systematically restated: the decision-collection iron rule ('禁止静默替用户选择…每项独立列出 + 等用户答复') appears near-verbatim in 硬性质检协议 rule 5, again in full in Phase 3, referenced again in Checkpoint 2, and recapped in 默认策略; the QA methods and cover/PDF/language policies are likewise duplicated between the 质检协议 table, phase sections, and 默认策略. Efficient overall with more than minor trimming opportunity — anchor 4, not 5; clearly above 3 since the redundancy is policy reiteration, not concept padding.

4 / 5

Actionability

Highly concrete throughout: executable commands ('bash <path-to-beautiful-article>/scripts/scaffold.sh ./my-article --theme=<id>', 'npm run typecheck / build', 'bash <skill>/scripts/html-to-pdf.sh'), a copy-paste Plan Checkpoint opening-message template, an exact workspace layout, section file-naming convention ('article/sections/NN-*.tsx'), and fully enumerated option tables with retention ratios. The gap: the primary Phase 4 entry command fails as bundled — scaffold.sh's theme validation greps '$SKILL_DIR/theme-profiles/index.json', which does not exist in the bundle, so even the default theme aborts with '未知主题'. Mostly executable with one real execution gap — anchor 4, not 5; well above 3 since nothing is vague or pseudocode.

4 / 5

Workflow Clarity

Exemplary sequencing: a Phase 0→8 overview diagram, three hard-stop checkpoints ('★Checkpoint 1 必须停…逐项确认 5 件事'), a per-node QA table mapping node→method→artifact with rationale, explicit feedback loops ('先按 fail 项把产出改完,再汇报…直接拿原始结论汇报但不修复 = 违规'), inline checklists, and a minimal-slice repair policy ('禁止只反馈一处就重写整篇'). This is exactly the anchor-5 pattern: clear sequence, explicit validation steps, error-recovery loops, and checklists for a complex process.

5 / 5

Progressive Disclosure

Navigation is excellent — a per-phase reading table ('各阶段文件读取指南…必读 | 按需查'), a resources table annotated by '何时读', and one-level-deep references, all of which resolve to real bundle files except one: the body instructs '读 theme-profiles/index.json' (Checkpoint 1 table), lists 'theme-profiles/*.md' in the Phase 2 reading guide, and 'theme-profiles/index.json + *.md' in the resources table, but no theme-profiles/ directory exists in the bundle (also required by scaffold.sh and 10+ cross-references in references/*.md). Good structure with one significant broken reference — anchor 4, not 5; clearly above 3 since signaling and content placement are otherwise exemplary.

4 / 5

Total

17

/

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.

A model description: concrete inputs and output format, an explicit bilingual trigger clause covering the full genre space, distinct protocol vocabulary, and a hard negative scope boundary. No vague fluff despite its length — every clause adds trigger or capability information.

DimensionReasoningScore

Specificity

Enumerates concrete inputs ('网页 URL / PDF / DOCX / Markdown / 纯文本 / 截图 / 粘贴材料'), a concrete deliverable ('单文件 HTML 网页文章' that is offline-openable and shareable), the mechanism ('基于 reacticle 组件协议…语义组件 + 受主题约束的 Raw 自由层'), the process ('source→规划→双确认→生成→终审→修复'), defaults ('默认 100% 信息保留的长文'), and explicit exclusions ('只生成文章,不生成后台、表单、dashboard、产品原型或通用 Web App'). This matches the anchor-5 pattern of multiple specific concrete actions with comprehensive coverage — not 4, since coverage has no minor gaps; not below, since nothing is vague.

5 / 5

Completeness

It explicitly answers both 'what' ('把用户提供的素材…编辑、设计成一篇美丽的…单文件 HTML 网页文章') and 'when' with a dedicated trigger clause ('触发场景:把 URL/PDF/DOCX/文章做成网页文章…'). This is the anchor-5 example pattern: what AND when with concrete trigger phrases; the 'Use when' cap at 3 does not apply because explicit trigger guidance is present.

5 / 5

Trigger Term Quality

The '触发场景' clause lists the natural genre terms users would say ('网页文章 / 长文 / briefing / 解释文 / 视觉文章 / 教程 / 审阅复盘 / 方案分析') plus verbatim user phrasings in two languages ('render this as a beautiful web article / 把这篇做成网页文章 / 生成一篇可分享的 HTML 长文 / reacticle 文章'), and format names (PDF, DOCX, HTML) that double as extensions. Comprehensive synonym coverage — anchor 5 rather than 4, where common terms would be missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (single-file HTML web articles authored via the 'reacticle' protocol) with distinct triggers and an explicit negative boundary that fences off adjacent skills ('不生成:后台、表单、拖拽工作台、完整 dashboard、产品原型、通用 Web App'). Minimal conflict risk — anchor 5; the 4 anchor's 'minor overlap risk with closely related skills' is avoided by the explicit exclusion list.

5 / 5

Total

20

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

ConardLi/garden-skills

Path

skills/beautiful-article/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.