CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

doc-limits

Load to add, tune, or debug document byte ceilings and DOC_LIMITS_* settings.

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 ./.agents/skills/doc-limits/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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, well-structured overview: executable commands, precise scope statements, and verified one-level-deep references with no padding. The only meaningful gap is that exit-code/error-ownership detail (the exit-2 'could not judge' case) lives entirely behind policy.md and --help rather than being summarized inline.

DimensionReasoningScore

Conciseness

The body is ~15 lines where every sentence carries harness-specific facts Claude could not know: "The commit-guards pre-commit and pre-push chains use the staged mode; at push the index is held equal to HEAD first", "measures `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` and `SKILL.md`... and no other file". There is no padding, no explanation of concepts Claude already knows, and no dead verbosity — a clear match for the score-5 anchor 'lean and efficient; every token earns its place', and above score 4 which permits minor trimmable over-explanation.

5 / 5

Actionability

Two copy-paste-ready executable commands are given ("scripts/doc-limits", "scripts/doc-limits --staged") plus direct pointers for the remaining surface ("Class selection and the exclusion format are [references/policy.md]", "Flags, settings and exit codes are in `doc-limits --help`"). This matches the score-4 anchor 'mostly executable guidance; concrete code or commands with minor gaps': the primary run-the-check cases are fully executable, but the tune/add-ceiling workflow itself is one reference hop away rather than shown inline, which keeps it below the score-5 anchor's 'specific examples cover the common cases' within the body.

4 / 5

Workflow Clarity

The single action is unambiguous (run the check; staged mode in the hook chains), failure semantics are stated ("A document over its limit fails the check"), and the remediation path is explicit ("A document that must stay whole gets a row in the configured excludes file with its reason"). This fits the score-4 anchor 'clear sequence with most checkpoints present; minor validation gaps' — the exit-2 'could not judge' outcome and its error-ownership levels are deferred to policy.md/--help rather than surfaced, which is the minor gap keeping it below 5; it is above 3 because failure meaning and remediation are both present, not merely implied.

4 / 5

Progressive Disclosure

The body is a concise overview with well-signaled, one-level-deep references that all resolve in the actual bundle: references/policy.md exists and contains the linked 'Path classes' section, scripts/doc-limits exists, and `doc-limits --help` is a real flag surface. Nothing that belongs in a separate file is inlined, matching the score-5 anchor 'clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'.

5 / 5

Total

18

/

20

Passed

Description

67%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 lean, third-person description with explicit load-when guidance and a distinctive DOC_LIMITS_* trigger. Its main weakness is trigger-term coverage: users would more likely mention CLAUDE.md/AGENTS.md being over a limit or the check failing than the phrase 'byte ceilings'.

Suggestions

Add the measured file names as trigger terms, e.g. 'Load to add, tune, or debug document byte ceilings (AGENTS.md, CLAUDE.md, GEMINI.md, SKILL.md) and DOC_LIMITS_* settings when the doc-limits check fails or a doc is over its limit.'

Include common user phrasings such as 'over the limit', 'file size limit', or 'doc-limits check' so natural queries surface the skill.

DimensionReasoningScore

Specificity

"add, tune, or debug document byte ceilings and DOC_LIMITS_* settings" lists several concrete actions (add, tune, debug) against a named configuration namespace, matching the score-4 anchor 'lists several specific actions; minor gaps in coverage'. It falls short of 5 because it omits what the skill actually executes (the byte-ceiling check over AGENTS.md/CLAUDE.md/GEMINI.md/SKILL.md) and the exclusion mechanism, and stays above 3 because three distinct concrete verbs on a specific target exceed the 1-2 actions of the score-3 anchor.

4 / 5

Completeness

"Load to add, tune, or debug document byte ceilings and DOC_LIMITS_* settings" supplies an explicit 'when' clause equivalent to 'Use when...' (load when you need to add/tune/debug) plus a clear 'what' (the settings/domain being managed), matching the score-4 anchor 'has both what and when; when could be more explicit or specific'. It is not capped at 3 because explicit trigger guidance is present, and it is not 5 because the 'what' is task-framing rather than a concrete statement of the capability, and the trigger phrases lack concrete file-name triggers.

4 / 5

Trigger Term Quality

Relevant keywords are present ("document byte ceilings", "DOC_LIMITS_* settings", "tune", "debug") but common variations a user would naturally say are missing: the measured file names (CLAUDE.md, AGENTS.md), "size limit", "over the limit", "check fails". This matches the score-3 anchor 'some relevant keywords but missing common variations or synonyms'; it is not 4 because the natural-phrase coverage has real gaps, and not 2 because it is more than one or two generic keywords.

3 / 5

Distinctiveness Conflict Risk

"document byte ceilings and DOC_LIMITS_* settings" carves a clear niche — the DOC_LIMITS_* namespace is a distinct, unique trigger with minimal conflict risk — but the generic word "document" leaves minor overlap risk with document-processing skills, fitting the score-4 anchor 'mostly distinct; minor overlap risk with closely related skills'. It is below 5 because "document" alone is broad enough that a generic document-skill query could weakly match.

4 / 5

Total

15

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

vanillagreencom/kendex

Path

.agents/skills/doc-limits/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.