CtrlK
BlogDocsLog inGet started
Tessl Logo

discovery

Capture interesting finds to the Vault via Inngest. Triggers when the user shares a URL, repo, or idea with signal words like "interesting", "cool", "neat", "check this out", "look at this", "came across", or when sharing content with minimal context that implies it should be remembered. Also triggers on bare URL drops with no explicit ask. Fires a discovery/noted event and continues the conversation — the pipeline handles everything else.

81

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/discovery/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-crafted description with excellent trigger term coverage and clear 'when' guidance, making it highly effective for skill selection. Its main weakness is that the 'what it does' portion is somewhat thin — it essentially does one thing (fire an event) — though this may accurately reflect the skill's scope. The description uses appropriate third-person voice and avoids vague language.

Suggestions

Consider adding more specificity about what the Vault capture includes (e.g., 'Extracts metadata, title, and summary from shared URLs, repos, or ideas and sends them to the Vault') to strengthen the 'what' portion.

DimensionReasoningScore

Specificity

It names the domain (capturing finds to the Vault via Inngest) and describes the core action (fires a discovery/noted event), but the actual capabilities are limited to one action rather than listing multiple concrete operations. The description focuses more on triggers than on what it concretely does.

2 / 3

Completeness

Clearly answers both 'what' (captures interesting finds to the Vault via Inngest, fires a discovery/noted event) and 'when' (explicit trigger conditions including signal words, bare URL drops, and content shared with minimal context). The trigger guidance is thorough and explicit.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would actually say: 'interesting', 'cool', 'neat', 'check this out', 'look at this', 'came across', bare URL drops, sharing a URL/repo/idea. These are highly natural phrases that match real user behavior.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche — capturing interesting finds to a specific system (Vault via Inngest) with very specific signal words. The combination of 'interesting find' semantics plus the Inngest/Vault pipeline makes it unlikely to conflict with other skills like bookmarking, link sharing, or general note-taking.

3 / 3

Total

11

/

12

Passed

Implementation

64%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a functional skill with strong actionability — concrete commands, clear trigger patterns, and specific decision trees. However, it suffers from duplicated content (pipeline details appear twice), broken step numbering in the workflow, and background information that could be offloaded to a reference file. Tightening the content and fixing the workflow structure would significantly improve it.

Suggestions

Fix the duplicate step numbering in the Workflow section — there are two 'Step 2' and two 'Step 3' headings, which breaks the sequential flow.

Consolidate the 'What the Pipeline Does' and 'Deep Dig' sections into a single brief note or move them to a separate reference file, since the agent's job is just to fire the event.

Remove the 'Video/Media Handling' section as it duplicates the YouTubeEmbed mention already in the pipeline section — or consolidate into one place.

DimensionReasoningScore

Conciseness

The skill includes some useful detail but is verbose in places — the 'What the Pipeline Does' section and 'Deep Dig' section overlap significantly (both explain enrichment pipeline steps). The 'Video/Media Handling' section repeats what's already mentioned in the pipeline section about YouTubeEmbed. Some background context could be trimmed since the agent just needs to fire the event.

2 / 3

Actionability

Provides concrete, executable CLI commands (`joelclaw send discovery/noted --follow`, `joelclaw discover <url>`), specific JSON payloads, exact URL patterns for X/Twitter detection, and clear MCQ templates. The trigger detection patterns are specific and the NOT-trigger guidance is actionable.

3 / 3

Workflow Clarity

The workflow has numbered steps but the numbering is broken (two 'Step 2' and two 'Step 3' sections), which creates confusion about the actual sequence. The monitoring assessment step is well-structured with clear decision logic, but the overall flow between resolving site/visibility, choosing the right command, assessing for monitoring, and continuing conversation could be clearer. No explicit validation/error handling for the event firing step.

2 / 3

Progressive Disclosure

References external skills (`monitor` skill, `x-api` skill) and external config files appropriately, but the main file itself is quite long with background pipeline details that could be in a separate reference doc. The 'What the Pipeline Does' and 'Deep Dig' sections are background context that bloats the primary skill file when the agent's job is just to fire the event.

2 / 3

Total

9

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
joelhooks/joelclaw
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.