CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

viral-generator-builder

You understand why people share things. You build tools that create "identity moments" - results people want to show off. You know the difference between a tool people use once and one that spreads like wildfire. You optimize for the screenshot, the share, the "OMG you have to try this" moment.

Quality

47%

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

Quality

Content

50%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 contains genuinely useful viral-mechanics heuristics and two concrete code snippets, but suffers a structural defect: pattern content (headers, tables, sub-blocks) is wrapped inside ```javascript fences, so most of the body renders as literal code. Combined with an undefined helper function and a missing build sequence, the guidance is present but not cleanly executable.

Suggestions

Fix the malformed nested code fences: pattern bodies like the Input Design table and "### Quiz Structure" are inside ```javascript wrappers, causing headers and tables to render as literal code — unwrap the markdown and fence only actual code.

Define simpleHash (or inline a working hash) so the deterministic name generator example is copy-paste runnable, and add one complete end-to-end generator example.

Drop the verbatim role/description duplication and the boilerplate "When to Use" line, replacing the latter with real trigger guidance; consider moving the three detailed patterns into reference files.

DimensionReasoningScore

Conciseness

The body is mostly tight (terse anti-patterns, compact tables) but includes clear padding: the role paragraph repeats the description verbatim, each pattern has a filler one-liner ("Building generators that go viral"), pattern headers are duplicated inside the fenced blocks ("## Generator Architecture" appears both as a section header and inside the code fence), and the closing line "This skill is applicable to execute the workflow or actions described in the overview" is pure boilerplate. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4, where over-explanation would be only minor.

3 / 5

Actionability

There is real concrete guidance — executable weighted-scoring code ("scores[answer.type] += answer.weight") and a deterministic name function — but it is incomplete: "simpleHash" is never defined so the generateName example is not copy-paste runnable, there is no complete end-to-end example, and much of the guidance is heuristic direction ("Include branding subtly", "Make text readable on mobile"). This matches anchor 3 ("some concrete guidance but incomplete; missing key details") rather than 4, whose code would be executable with only minor gaps. The malformed nested code fences also blur what is instruction versus code.

3 / 5

Workflow Clarity

Sequences exist ("Input (minimal) → Magic (your algorithm) → Result (shareable)" and "5-10 questions → Weighted scoring → One of N results") and each pattern has a "When to use" marker, but there is no ordered build process and no validation or verification checkpoints — matching anchor 3 ("sequence present but checkpoints missing or implicit"). This is not a destructive/batch skill, so no lower cap applies, but it cannot reach 4 without an explicit step sequence.

3 / 5

Progressive Disclosure

The skill is a single monolithic ~200-line file with no bundle files at all; sections are reasonably organized (Capabilities, Patterns, Anti-Patterns, Related Skills) but the three detailed pattern bodies — exactly the material that belongs in reference files — are fully inlined, and the guidelines' 5-score exception applies only to skills under 50 lines. This fits anchor 3 ("some structure but could be better organized; content that should be separate is inline").

3 / 5

Total

12

/

20

Passed

Description

20%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 persona-flavored fluff written in second person: it conveys a vibe ("identity moments", "spreads like wildfire") but names no concrete capabilities and provides zero trigger guidance, so Claude would rarely know when to load it. It reads as a character brief rather than a skill description.

Suggestions

Rewrite in third person naming concrete artifacts, e.g. "Builds viral generator tools: personality quizzes, name/text generators, avatar generators, and shareable calculators with optimized share cards."

Add an explicit trigger clause: "Use when the user asks to build a quiz, personality test, name generator, avatar generator, or any tool designed to be shared or go viral."

Replace buzzword phrases ("identity moments", "spreads like wildfire", "OMG you have to try this") with specific actions and natural keywords users would say.

DimensionReasoningScore

Specificity

The description is a second-person persona statement ("You understand why people share things", "You build tools that create 'identity moments'") with no concrete actions; it already only weakly matched anchor 2 ("Names the domain but actions are minimal or generic"), and the rubric's second-person penalty ("You build", "You know", "You optimize") reduces it by 1 to 1. Buzzword phrases like "spreads like wildfire" and "the 'OMG you have to try this' moment" add no actionable specifics.

1 / 5

Completeness

The "what" is vague ("You build tools that create 'identity moments' - results people want to show off") and the "when" is completely missing — no "Use when..." clause or equivalent trigger guidance — which is an exact match for anchor 2 ("Has a vague 'what' and no 'when'"). It cannot score 3 because the what itself never names concrete deliverables, and 1 would require both to be entirely absent.

2 / 5

Trigger Term Quality

Only one or two generic keywords appear ("share", "screenshot", "show off"), while the natural phrases a user would actually say — "generator", "quiz", "personality test", "name generator", "viral" — are entirely absent, matching anchor 2 rather than 3 whose keyword set is at least relevant to the domain.

2 / 5

Distinctiveness Conflict Risk

The persona framing ("You understand why people share things", "You optimize for the screenshot, the share") overlaps heavily with marketing, growth, and social-media skills, and the description never names its actual subject (generator/quiz tools), so it would not trigger distinctively — fitting anchor 2 ("Very broad; high overlap risk with many similar skills").

2 / 5

Total

7

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/viral-generator-builder/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.