CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

report-generator

Use when the user asks to "create a campaign report", "build an executive summary", or "deliver client results"; produces audience-tailored influencer marketing reports (executive, client, internal team) with data tables, narrative, key learnings, and recommendations. Not for raw metric computation — use performance-analyzer. 达人营销报告/结案汇报

Quality

79%

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 ./influencer/report/report-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

66%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 well-structured and highly actionable with a clear sequenced workflow, explicit validation/NEEDS_INPUT checkpoints, and correct use of a single one-level-deep reference file. Its main weakness is token efficiency: the identity-ref and authorization contract is repeated roughly four times across the Skill Contract and Instructions, consuming a large share of the body without adding new guidance.

Suggestions

State the opaque-ref and exact-authorization rules once in a single canonical section (e.g., the Writes bullet) and cross-reference it from Done-when #5 and Instructions 1 and 6 instead of restating it verbatim — this alone would cut roughly a third of the body.

Trim step 6 to the essential decision points (offer WARM save, transient render rule, distribution needs fresh authorization) and drop the repeated enumeration of every ref kind, which already appears in the Skill Contract.

Compress the Reference Materials and Next Best Skill lists into one compact handoff line per skill; eight-plus deep relative links (../../../...) are unverifiable from the bundle and dilute the single genuine bundle reference.

DimensionReasoningScore

Conciseness

Noticeably padded: the opaque-ref/authorization rules are restated at least four times ("Every saved report, template field, appendix, and handoff uses opaque `client_ref`..." in Writes; again in Done-when #5; "Keep any raw identity/contact locator transient" in step 1; and the full restatement in step 6), and the Promotes bullet plus the paid-ads blockquote add contract boilerplate that crowds out report-writing guidance. It is not a 3 because the duplication is substantial rather than a few stray sentences that could be tightened.

2 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: Quick Start invocations, seven specific steps with fallback behavior ("If the required computed artifact is absent, return a partial shell plus `NEEDS_INPUT` and the exact handoff; do not recompute"), and a worked Example with a filled metrics table. Not a 5 because the in-body example covers only the executive audience; client/team cases live entirely in the reference file.

4 / 5

Workflow Clarity

Seven clearly numbered steps (determine parameters → pick template → apply guidance → close with recommendations → preserve Retro Card → return/persist → offer next skill) with explicit validation branches for every failure mode: absent artifacts yield a "partial shell plus `NEEDS_INPUT`", and an "absent, mismatched, or stale" Retro Card yields a "bound `decision: unknown` placeholder". The five-item "Done when" checklist closes the loop with verifiable exit criteria.

5 / 5

Progressive Disclosure

Good structure: 543 lines of full templates are correctly split into a real, one-level-deep, well-signaled reference ("full executive, client, and internal-team templates live in [report-templates.md](references/report-templates.md)") cited consistently. Not a 5 because the body carries 8+ out-of-bundle relative links with deep paths (e.g., ../../../seo-geo/tune/content-quality-auditor/SKILL.md) that cannot be verified from the bundle and add navigation clutter.

4 / 5

Total

15

/

20

Passed

Description

87%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 with concrete quoted trigger phrases, a clear what/when pair, an explicit negative boundary, and bilingual synonyms. The only gaps are verb diversity in the capability list and a few missing natural variations (wrap-up, results deck, periodic reports).

Suggestions

Add one or two natural trigger variations such as "post-campaign wrap-up" or "monthly/quarterly performance report" to broaden the when-clause keyword coverage.

Vary the capability verbs (e.g., "builds data tables, writes narrative summaries, distills key learnings, drafts recommendations") to sharpen the action list beyond the single verb "produces".

DimensionReasoningScore

Specificity

Lists several concrete deliverable components — "data tables, narrative, key learnings, and recommendations" for "executive, client, internal team" audiences — plus an explicit exclusion ("Not for raw metric computation"). Not a 5 because the action list is dominated by a single verb ("produces") with components, rather than multiple distinct concrete actions.

4 / 5

Completeness

Explicitly answers both: what ("produces audience-tailored influencer marketing reports (executive, client, internal team) with data tables, narrative, key learnings, and recommendations") and when ("Use when the user asks to..." with concrete quoted trigger phrases), plus a negative boundary. This matches the anchor-5 example structure exactly.

5 / 5

Trigger Term Quality

Strong natural trigger phrases in quotes ("create a campaign report", "build an executive summary", "deliver client results") plus bilingual synonyms ("达人营销报告/结案汇报") that a user would plausibly say. Not a 5 because common variations like "post-campaign wrap-up", "results deck", or "monthly/quarterly report" are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

Clear niche ("influencer marketing reports") with distinct quoted triggers, and the explicit exclusion "Not for raw metric computation — use performance-analyzer" actively disambiguates from the closest sibling skill. Minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 20 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

influencer/report/report-generator/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.