video-note
Transform Obsidian video notes from the Vault into published notes on joelclaw.com. Use when publishing video notes, converting vault video content to the site, or when asked to 'publish a video note,' 'turn this video into a note,' 'publish from vault/videos,' or any task involving /Vault/Resources/videos → joelclaw content. Triggers on references to video notes, vault video files, or publishing video content to the blog.
91
88%
Does it follow best practices?
Impact
99%
1.73xAverage score across 3 eval scenarios
Passed
No known issues
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 strong skill description with excellent trigger term coverage and completeness. It clearly defines when to use the skill with multiple natural phrasings and explicit path references. The main weakness is that the 'what' portion could be more specific about the concrete transformation steps involved beyond the high-level 'transform and publish' action.
Suggestions
Add 2-3 specific sub-actions to increase specificity, e.g., 'Extracts video metadata, formats transcript content, generates frontmatter, and publishes as a blog post on joelclaw.com.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Obsidian video notes, Vault, joelclaw.com) and the core action (transform/publish), but it doesn't list multiple specific concrete actions like extracting metadata, formatting markdown, generating frontmatter, etc. It's essentially one action described in different ways. | 2 / 3 |
Completeness | Clearly answers both 'what' (transform Obsidian video notes from the Vault into published notes on joelclaw.com) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios and a 'Triggers on' clause). Both dimensions are well-covered. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'publish a video note,' 'turn this video into a note,' 'publish from vault/videos,' 'video notes,' 'vault video files,' 'publishing video content to the blog,' and the specific path '/Vault/Resources/videos.' These are phrases a user would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: specifically video notes from a specific Vault path to a specific site (joelclaw.com). The combination of Obsidian Vault, video notes, and the target blog makes it very unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill that efficiently communicates a specific content transformation workflow with concrete schemas, clear steps, and good progressive disclosure to supporting references. Its main weakness is the lack of any validation or verification steps in the workflow — there's no checkpoint to confirm the output MDX is valid or renders correctly before considering the task complete. Overall it's a strong skill that would benefit from a small addition of verification guidance.
Suggestions
Add a validation step after writing the MDX file (e.g., 'Verify frontmatter has all required fields and the YouTube component ID is correct before considering the note published')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section earns its place — source format, output format, transformation steps, and references are all specific to this workflow. No unnecessary explanations of what Obsidian or MDX are. The skill assumes Claude's competence throughout. | 3 / 3 |
Actionability | Provides concrete frontmatter schemas for both input and output, a specific 7-step transformation workflow with clear sub-instructions (e.g., 'Strip Obsidian syntax: `> [!info]` callouts → plain text'), exact file paths, slug conventions, and component usage (`<YouTube id="VIDEO_ID" />`). Fully actionable. | 3 / 3 |
Workflow Clarity | The 7-step workflow is well-sequenced and detailed, but there are no validation or verification checkpoints. Since this involves content transformation and publishing (a semi-destructive operation that could publish malformed content), the absence of any 'verify the MDX renders correctly' or 'check frontmatter validity' step is a gap. | 2 / 3 |
Progressive Disclosure | Clean overview structure with well-signaled one-level-deep references: writing style skill, voice examples, content-system.md, and example-note.md. The main SKILL.md stays focused on the workflow while pointing to detailed references for voice, content system, and examples. | 3 / 3 |
Total | 11 / 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 | |
- Repository
- joelhooks/joelclaw
- Commit
03f0a59
- 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.