CtrlK
BlogDocsLog inGet started
Tessl Logo

doc-kami-parchment

Warm parchment canvas (#f5f4ed), monochrome ink-blue accent (#1B365D), one serif family, and editorial-grade typography.

51

Quality

56%

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 ./skills/doc-kami-parchment/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a lean, well-structured design spec that efficiently delivers concrete visual rules and per-document-type structures. Its main gaps are the lack of an executable HTML/CSS starter template and missing guidance for choosing among the eight document types.

Suggestions

Add a minimal copy-paste HTML/CSS starter (font-family stacks, the color tokens, the hairline rule) so the template skeleton is executable rather than inferred.

Provide brief decision guidance for selecting a document type from the eight options based on user content signals (length, structure, purpose).

For multi-page outputs (Long Doc, Slides), note a quick validation step such as confirming page count or section breaks before finalizing.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence: it never explains known concepts (what a serif is, what Tailwind is) and packs every line with concrete specs (hex values, font stacks, line-height ranges, forbidden effects) so each token earns its place.

3 / 3

Actionability

It gives concrete, specific values (exact hex colors, named font fallback chains, line-height ranges) but no executable HTML/CSS starter skeleton for a skill whose output is a single-file HTML page, leaving implementation details to interpretation.

2 / 3

Workflow Clarity

Document-type structures are sequenced clearly (e.g. Long Doc: 封面页 → 目录 → 章节 → 注释脚注 + 文末 colophon), but there are no validation/feedback checkpoints and selection among the eight doc types is left to "按用户内容判断" with no decision guidance.

2 / 3

Progressive Disclosure

It is a single well-organized file under 50 lines with no external references, and its sections (意图, 硬性视觉签名, 可选文档类型, 设计准则) are clearly labeled and easy to navigate — meeting the simple-skills exception for progressive disclosure.

3 / 3

Total

10

/

12

Passed

Description

40%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a precise statement of visual design tokens but functions as a style caption rather than a capability description: it states no actions and no usage triggers. It is distinguishable by aesthetic yet weak on trigger and completeness guidance.

Suggestions

Lead with the skill's action, e.g. "Turns content into a warm parchment one-pager / long-form document with editorial typography and a single serif family."

Add an explicit trigger clause: "Use when the user wants a serif, editorial, print-like document (report, letter, resume, changelog, one-pager) rather than a dashboard or web page."

Include concrete task nouns (document, report, letter, resume, one-pager) so natural user phrasing matches the description.

DimensionReasoningScore

Specificity

The description lists visual attributes ("Warm parchment canvas (#f5f4ed)", "monochrome ink-blue accent (#1B365D)", "one serif family", "editorial-grade typography") but names zero concrete actions the skill performs — it describes how the output looks, not what the skill does.

1 / 3

Completeness

It gives a partial "what" (the visual signature) but provides no "Use when..." clause or equivalent trigger guidance; per the rubric guideline, a missing explicit trigger caps completeness at 2.

2 / 3

Trigger Term Quality

It includes some relevant design-domain keywords a user might say ("parchment", "serif", "editorial-grade typography") but omits common task-oriented terms like document, report, letter, or one-pager that appear only in the tags and body.

2 / 3

Distinctiveness Conflict Risk

The aesthetic (warm parchment + ink-blue + serif) is a fairly distinct niche, but with no task-oriented triggers it could still overlap with sibling doc-category template skills in the same family.

2 / 3

Total

7

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
nexu-io/open-design
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.