CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

url-dump

Quick capture URLs with automatic content extraction, insights, and categorization into knowledge booklets

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/url-dump/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%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 and features an unusually strong workflow with explicit validation, retry, and escalation logic. Its weaknesses are length-driven: aspirational non-actionable sections pad the token budget, and the monolithic single-file structure inlines template material that would be better split into reference files.

Suggestions

Delete or compress the 'Success Metrics' and 'Learning and Adaptation' sections — they describe unimplementable aspirations ('learn user's categorization preferences') that consume context without guiding execution.

Move the full bookmark template, tool template, and category index template into a references/ file (e.g. templates.md) and keep only field summaries inline, reducing the SKILL.md to an overview with one-level-deep pointers.

The external pointer to '.claude/skills/loop-engineering/SKILL.md' relies on a path outside the skill bundle; inline the essential loop vocabulary or verify that dependency exists in the deployment environment.

DimensionReasoningScore

Conciseness

The body is mostly efficient — templates, prompts, and file paths carry real weight — but the 'Success Metrics' and 'Learning and Adaptation' sections are aspirational padding Claude cannot act on ('Track which bookmarks get revisited', 'Improve relevance scoring based on engagement'), and the ~460-line body could be tightened. This fits anchor 3 (mostly efficient, some unnecessary content that could be trimmed) rather than anchor 2, since the verbosity is confined to a few sections rather than pervasive padding.

3 / 5

Actionability

Guidance is fully executable: exact user-facing prompts ('What URL(s) would you like to save?'), copy-paste-ready bookmark and tool markdown templates with complete frontmatter, exact save paths ('05-knowledge/booklets/[category-slug]/[title-slug]-YYYY-MM-DD.md'), a batch summary format, and correct/incorrect YAML examples covering the common cases. This matches anchor 5; it is not anchor 4 because the templates and paths leave no gaps to fill.

5 / 5

Workflow Clarity

The 8-step Process Flow is clearly sequenced, and the Loop Engineering section adds an explicit deterministic quality gate, a ~3-attempt retry cap, layered termination conditions, and human escalation for low-confidence categorization — exactly the validate→fix→retry feedback loop the rubric demands for batch operations. Validation is explicit and embedded (not merely listed elsewhere), matching anchor 5 over anchor 4.

5 / 5

Progressive Disclosure

There are no bundle files at all (references/, scripts/, assets/ absent), so everything lives in a single ~460-line SKILL.md. Section headers provide reasonable structure, but content that clearly belongs in separate reference files — the full bookmark template, tool template, category index template, and booklet structure tree — is inlined, matching anchor 3 (some structure, content that should be separate is inline). It is above anchor 2 because the inlined content is well-sectioned and navigable, not a header-less wall.

3 / 5

Total

16

/

20

Passed

Description

58%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 has a clear, multi-action 'what' with a distinct URL-capture niche, but it completely lacks a 'when to use' clause and the natural trigger phrases ('save this link', 'bookmark this') that the skill's own body identifies, limiting discoverability and completeness.

Suggestions

Append an explicit 'Use when...' clause with concrete trigger phrases, e.g. 'Use when the user shares a URL to save, or says "save this link", "bookmark this", "url dump", or "save for later".'

Add natural synonyms to widen triggering: 'links', 'bookmarks', 'save for later', alongside 'URLs'.

Optionally mention the fetch/insight generation steps ('fetches the page, generates insights and summaries') to round out action coverage toward comprehensive.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Quick capture URLs with automatic content extraction, insights, and categorization into knowledge booklets' — naming the domain plus capture, extraction, insight generation, and categorization. It falls short of anchor 5 because coverage is compact and misses supporting actions (e.g., fetching page content, organizing into a knowledge base), but exceeds anchor 3 by naming more than 1-2 actions.

4 / 5

Completeness

The 'what' is clear (capture URLs with extraction, insights, and categorization), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the judging guidelines cap at 3. It cannot score 4/5 because 'when' is entirely absent rather than merely implicit or less specific.

3 / 5

Trigger Term Quality

It contains relevant keywords ('capture URLs', 'content extraction', 'categorization') but is missing the natural phrases users actually say per the body's own trigger list — 'save this link', 'bookmark this', 'save for later' — and common variations like 'link'. This matches anchor 3 (some relevant keywords, missing common variations/synonyms) rather than anchor 4, whose example shows denser natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

URL capture with categorization into knowledge booklets is a mostly distinct niche with 'URL' as a strong trigger, having only minor overlap risk with closely related knowledge-management skills (e.g., general braindump/knowledge-consolidation). It is not anchor 5 because it lacks explicit trigger phrases that would make it unambiguous against those sibling skills.

4 / 5

Total

14

/

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

huytieu/COG-second-brain

Path

.claude/skills/url-dump/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.