CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

caveman-help

Quick-reference card for the three caveman skills and their commands. Trigger: /caveman-help or "caveman help".

64

Quality

80%

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/caveman-help/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A tight, highly actionable reference card: concrete triggers, copy-paste configuration, and an unambiguous one-shot workflow. The only flaws are a duplicated manual/off configuration explanation and a config section that pushes the body past quick-reference length.

DimensionReasoningScore

Conciseness

The body is lean and table-driven with terse prose, but the manual/off configuration is explained twice ("For opt-in activation... set defaultMode to manual" and again "Set \"off\" to suppress... Use \"manual\" when bare /caveman should activate"), which is a minor trimmable redundancy keeping it at anchor 4 rather than anchor 5.

4 / 5

Actionability

Guidance is fully executable: exact triggers per mode and skill, copy-paste-ready `export CAVEMAN_DEFAULT_MODE=ultracave` and JSON config snippets, an explicit resolution order ("env var > repo config > user config > caveman"), and legacy value handling — matching anchor 5.

5 / 5

Workflow Clarity

As a simple single-purpose skill, its one action is unambiguous: "Display this reference card when invoked. One-shot — do NOT change mode, write flag files, or persist anything." There are no destructive or batch operations, so the simple-skill exception applies and the action plus explicit prohibitions merit a 5.

5 / 5

Progressive Disclosure

Sections are well-organized (Modes, Skills, Deactivate, Language, Configure, More) with a clearly signaled one-level external link ("Full docs: https://github.com/JuliusBrussee/caveman") and no bundle files to reference. However, the body runs ~56 lines — just past the under-50 guideline — and the dense default-mode configuration could live in the external docs, fitting anchor 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

62%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 clearly states what the skill is and gives an explicit, natural trigger, but it stays narrowly command-focused. It would benefit from naming the three skills/modes and adding situational trigger phrases beyond the literal invocation.

Suggestions

Enumerate the three skills or modes (caveman, ultracave, megacave) in the description so the "what" is concrete rather than a count.

Add situational trigger phrases beyond the literal command, e.g., "Use when the user asks what caveman modes exist or how to switch them".

Include natural variations such as "caveman modes" or "caveman commands" to broaden trigger coverage and reduce overlap with sibling caveman skills.

DimensionReasoningScore

Specificity

"Quick-reference card for the three caveman skills and their commands" names the domain and one concrete deliverable, but does not enumerate the skills or commands themselves, so coverage is not comprehensive (anchor 3) rather than listing several specific actions (anchor 4).

3 / 5

Completeness

Both "what" (a quick-reference card for the three caveman skills and their commands) and "when" (explicit "Trigger:" guidance) are present, so it clears the missing-trigger cap; however, the "when" covers only direct invocation with no situational trigger phrases, fitting anchor 4 rather than the concrete situational triggers of anchor 5.

4 / 5

Trigger Term Quality

"Trigger: /caveman-help or \"caveman help\"" provides a natural, relevant phrase, but both forms are the same invocation and common variations or synonyms (e.g., "caveman modes", "caveman commands") are missing, matching anchor 3 rather than the broader coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

"caveman help" is a distinct trigger with a clear niche, but the shared "caveman" keyword across sibling caveman skills creates minor overlap risk with closely related skills, matching anchor 4 rather than the minimal conflict risk of anchor 5.

4 / 5

Total

14

/

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

JuliusBrussee/caveman

Path

skills/caveman-help/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.