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.
64
77%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/discovery/SKILL.mdQuality
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 strong skill description with excellent trigger term coverage and clear when/what guidance. Its main weakness is that the 'what it does' portion is somewhat thin — it essentially fires an event and continues the conversation — but this may accurately reflect the skill's scope. The description is well-suited for disambiguation among many skills due to its distinctive trigger vocabulary and specific destination system.
| Dimension | Reasoning | Score |
|---|---|---|
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 trigger conditions 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 with signal words, bare URL drops, content shared with minimal context). The 'Triggers when...' clause serves as an explicit 'Use when' equivalent. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'interesting', 'cool', 'neat', 'check this out', 'look at this', 'came across', bare URL drops, sharing a URL/repo/idea. These are highly natural phrases users would actually say. | 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 casual sharing language + URL/repo/idea + the Vault destination makes it unlikely to conflict with other skills. | 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, actionable skill with concrete CLI commands and good trigger detection patterns. Its main weaknesses are verbosity (background pipeline details that the agent doesn't need to act on are included inline), a numbering error in the workflow steps, and lack of error handling/validation for the event-firing step. The content would benefit from moving background/reference material to separate files and fixing the step numbering.
Suggestions
Fix the duplicate step numbering (two '### 2' and two '### 3' sections) to create a clear, unambiguous sequence.
Move the 'What the Pipeline Does' and 'Deep Dig' background sections to a separate reference file (e.g., PIPELINE.md) since the agent's job is explicitly just to fire the event — these sections are informational, not actionable.
Add error handling guidance: what should the agent do if `joelclaw send discovery/noted --follow` fails or times out?
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains useful information but is verbose in places — the 'What the Pipeline Does' section explains background that the agent doesn't need to act on, the Deep Dig section repeats that enrichment is automatic multiple times, and some sections like Video/Media Handling restate what's already covered in the pipeline description. However, most content is relevant and not explaining basic concepts Claude already knows. | 2 / 3 |
Actionability | Provides fully executable CLI commands (`joelclaw send discovery/noted --follow`, `joelclaw discover <url>`), concrete data payloads with JSON, specific URL patterns for trigger detection, and clear MCQ templates for monitoring recommendations. The guidance is copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | The workflow has clear steps but the numbering is broken (two sections labeled '### 2' and '### 3'), which creates confusion. The decision tree for monitoring assessment is well-structured with clear conditionals, but there's no explicit validation/error handling for when the `--follow` command fails or the event doesn't fire successfully. The trigger detection vs. non-trigger distinction is a good checkpoint. | 2 / 3 |
Progressive Disclosure | References to other skills (`monitor` skill, `x-api` skill) and external config files (`tracked-projects.ts`) are mentioned but the skill itself is fairly long with background information (pipeline details, Deep Dig section) that could be split into reference files. No bundle files are provided, so all content is inline in a single document that runs quite long. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
03f0a59
Table of Contents
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.