CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

invoice

A printable invoice page — sender + recipient block, line items table, tax breakdown, totals, and payment instructions. Use when the brief mentions "invoice", "bill", "billing statement", or "发票".

64

Quality

81%

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

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

An extremely lean, well-sectioned body with a concrete layout spec and output contract, but it is undermined by a dangling reference (DESIGN.md does not exist in the bundle) and by instruction-level gaps on the print stylesheet and arithmetic details. Conciseness is exemplary; workflow and disclosure pay the price of the missing file.

Suggestions

Ship the DESIGN.md the workflow depends on (frontmatter requires color, typography, layout, and components sections) or remove the 'Read DESIGN.md' step — the workflow's first step is currently unexecutable.

Replace the 'Print stylesheet @media print to remove backgrounds' hint with a short concrete snippet (e.g., a minimal @media print block hiding backgrounds/links and setting page margins) so the print step is copy-paste ready.

Add a lightweight validation checkpoint to the workflow, e.g., verify the totals block (subtotal − retainer + tax = total due) against the line items before emitting the artifact.

DimensionReasoningScore

Conciseness

The body is ~30 lean lines: a one-line goal ("Produce a single-page printable invoice"), a tight numbered layout spec, and a minimal output contract — every token earns its place and nothing explains concepts Claude already knows. This matches the 5 anchor ('lean and efficient; assumes Claude's competence'); it does not warrant 4 territory since there is no over-explanation to trim.

5 / 5

Actionability

Concrete structural guidance is present: exact table columns ("description / qty / unit / amount"), totals block fields ("subtotal, retainer, tax, total due"), and a literal artifact contract with type and title. It sits at 4 rather than 5 because details like the "Print stylesheet @media print to remove backgrounds" step are hints rather than executable code, and tax/retainer computation, currency formatting, and payment-instruction fields are left unspecified.

4 / 5

Workflow Clarity

The sequence (1. Read DESIGN.md → 2. Layout → 3. Print stylesheet → output contract) is clearly ordered, but step 1 points at a DESIGN.md that does not exist anywhere in the bundle (no references/, scripts/, or assets/ directories), so the workflow cannot be followed as written. That broken first step, plus no validation of the produced artifact (e.g., checking totals arithmetic or that all line items render), places it at the 3 anchor ('steps listed but gaps') rather than 4; this is not a destructive/batch operation, so the 3-cap rule is not the driver.

3 / 5

Progressive Disclosure

For a sub-50-line single-purpose skill the structure (## Workflow, ## Output contract) is well organized, but the body's only external reference — "Read DESIGN.md" — is dangling, and the frontmatter's design_system requirement implies a design reference that is absent. Per the guideline to score against the actual bundle structure, the broken reference prevents both the simple-skill 5 and the 4 anchor; it lands at 3 ('references present but' unusable / organization gaps that block navigation).

3 / 5

Total

15

/

20

Passed

Description

83%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 component inventory, explicit 'Use when' clause with natural trigger phrases in two languages, and a well-defined niche. The only weaknesses are a generic single-word trigger ("bill") and inventory-style phrasing that lists page parts rather than actions.

DimensionReasoningScore

Specificity

"A printable invoice page — sender + recipient block, line items table, tax breakdown, totals, and payment instructions" enumerates several concrete deliverable components, matching the 'lists several specific actions; minor gaps' anchor. It falls short of 5 because it is a noun-phrase inventory of page parts rather than a comprehensive statement of actions performed, and it omits anything about styling/design-system application or the printable/print-orientation aspect beyond the adjective.

4 / 5

Completeness

It explicitly answers both what ("A printable invoice page — sender + recipient block, line items table, tax breakdown, totals, and payment instructions") and when ("Use when the brief mentions 'invoice', 'bill', 'billing statement', or '发票'") with concrete trigger phrases, which matches the 5 anchor almost verbatim. It is not 4 because the 'when' clause is fully explicit, not merely present-but-imprecise.

5 / 5

Trigger Term Quality

The triggers "invoice", "bill", "billing statement", "发票" are natural terms a user would actually say, giving good keyword coverage including bilingual synonyms — a fit for the 4 anchor. It is not 5 because common variations like "tax invoice", "statement of account", "账单" appears only in the triggers list and not the description body, and no file/format extensions are covered (though invoices have no canonical extension, coverage is still not exhaustive).

4 / 5

Distinctiveness Conflict Risk

The invoice domain is a clear niche with mostly distinct triggers, but the bare term "bill" is generic enough to fire on unrelated requests (e.g., a bill of materials, utility-bill parsing), which is exactly the 'minor overlap risk with closely related skills' situation of the 4 anchor. It is not 5 because of that "bill" ambiguity, and not 3 because the remaining triggers are unambiguous and domain-specific.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

design-templates/invoice/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.