CtrlK
BlogDocsLog inGet started
Tessl Logo

generate-report-header

Create standardized report headers with metadata for all agent-generated reports. Use when generating bug reports, security audits, dependency reports, or any worker output requiring consistent formatting.

64

Quality

75%

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 ./.claude/skills/generate-report-header/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 highly actionable with a well-specified input/output contract and illustrative examples, and the workflow is clearly sequenced with error handling. Its weaknesses are redundant field listings, a post-hoc rather than in-flow validation checklist, and a broken self-referencing pointer to a nonexistent template.md.

Suggestions

Remove the dangling Supporting Files section or actually ship template.md; the current reference is circular ('see Supporting Files section') and the file does not exist in any bundle directory.

Cut the redundant 'Standard Metrics' and Step 5 'Optional Fields' lists — they duplicate fields already specified in Step 1 (Timestamp, Duration, Workflow, Phase) and add token cost without new information.

Convert the post-hoc Validation checklist into an explicit in-workflow checkpoint (e.g., a Step 6 that verifies the generated header against the output template) to strengthen workflow clarity.

DimensionReasoningScore

Conciseness

The body is mostly efficient (typed input spec, output template, compact examples) but contains redundant sections: "Standard Metrics" and Step 5's "Optional Fields" re-list fields already defined in Step 1 (Timestamp, Duration, Workflow, Phase), and the Supporting Files line is circular. Multiple padded/redundant sections rather than minor trims place it at 3, not 4.

3 / 5

Actionability

Fully concrete and executable for an instruction skill: typed expected-input fields with examples, an exact output markdown template, a status-to-emoji mapping table, a timestamp format spec, and four complete input→output examples covering success, partial, and failed cases. This matches the 'fully executable, covers common cases' anchor.

5 / 5

Workflow Clarity

A clear five-step sequence with an Error Handling section providing recovery paths (e.g., "Invalid Timestamp: Use current time and warn"). However, the Validation section is a post-hoc checklist rather than an in-workflow checkpoint, and there is no step verifying the generated header against the template, so it falls short of the explicit-checkpoint anchor of 5.

4 / 5

Progressive Disclosure

Sections are well-organized with clear headers, but the only external reference — "`template.md`: Report header template (see Supporting Files section)" — points to a file that does not exist in any bundle directory and uses a circular self-referencing description. A dangling reference plus ~150 lines of examples that could live in a separate file matches the 'references present but not clearly signaled / could be better organized' anchor of 3, not 4.

3 / 5

Total

15

/

20

Passed

Description

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

The description is strong: it explicitly states both capability and usage triggers with concrete, natural trigger terms and third-person voice. Its main weaknesses are modest action specificity and some missing trigger synonyms.

DimensionReasoningScore

Specificity

"Create standardized report headers with metadata" names the domain with 1-2 concrete actions but no broader action coverage, matching the 'Names domain and 1-2 concrete actions' anchor. It does not list several specific actions (e.g., formatting timestamps, mapping statuses, embedding metadata), so it is not a 4.

3 / 5

Completeness

Explicitly answers both what ("Create standardized report headers with metadata for all agent-generated reports") and when ("Use when generating bug reports, security audits, dependency reports, or any worker output requiring consistent formatting") with concrete trigger phrases, matching the anchor-5 example pattern. The when-clause is fully explicit, not merely present, so it is above the 4 anchor.

5 / 5

Trigger Term Quality

Includes good natural trigger terms users would say — "bug reports", "security audits", "dependency reports", "consistent formatting" — but misses common variations such as "summary", "validation report", or "audit report header". Coverage is good but not comprehensive, so 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The niche (headers for agent-generated reports) is mostly distinct with targeted triggers like "bug reports" and "worker output". There is minor overlap risk with general document-formatting or report-writing skills, so it does not reach the clear-niche anchor of 5.

4 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
maslennikov-ig/claude-code-orchestrator-kit
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.