Joel's writing voice and style guide for joelclaw.com content. Use when writing, editing, or reviewing any blog post, essay, book chapter, or prose content for joelclaw.com. Also use when asked to 'write like Joel,' 'match Joel's voice,' 'draft a post,' 'write content for the blog,' or 'review this for voice.' This skill captures Joel's specific writing patterns derived from ~90,000 words of published content spanning 2012–2026. Cross-reference with copy-editing and copywriting skills for marketing-specific copy.
87
83%
Does it follow best practices?
Impact
92%
1.05xAverage 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 terms, clear completeness (both what and when), and high distinctiveness due to its personal/site-specific nature. The main weakness is that the specificity of capabilities could be improved by listing concrete style characteristics or patterns rather than just the general actions of writing/editing/reviewing. The cross-reference to related skills is a nice touch for disambiguation.
Suggestions
Add 1-2 specific style characteristics to improve specificity, e.g., 'Applies Joel's conversational tone, short-paragraph structure, and first-person narrative style' rather than just referencing the general domain.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (writing voice/style guide for joelclaw.com) and some actions (writing, editing, reviewing blog posts, essays, book chapters), but doesn't list specific concrete capabilities like tone characteristics, structural patterns, or vocabulary preferences that the skill actually applies. | 2 / 3 |
Completeness | Clearly answers both 'what' (Joel's writing voice and style guide for joelclaw.com content, derived from ~90,000 words of published content) and 'when' (explicit 'Use when...' clause with multiple trigger scenarios, plus cross-reference guidance for related skills). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'write like Joel,' 'match Joel's voice,' 'draft a post,' 'write content for the blog,' 'review this for voice,' plus mentions of specific content types (blog post, essay, book chapter, prose). These are phrases a user would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — it's specifically tied to Joel's personal voice for joelclaw.com, which is a unique niche. The cross-reference note about copy-editing and copywriting skills further helps disambiguate from related but different skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable writing style guide that provides concrete, specific guidance for matching Joel's voice. Its greatest strengths are the abundance of real corpus examples, the critical fabrication rule with clear decision logic, and the comprehensive anti-patterns table. Its main weakness is length — at 2000+ words it could benefit from splitting some reference material (anti-patterns table, content types, voice examples) into separate files, and a few sections repeat their core points more than necessary.
Suggestions
Consider moving the extensive anti-patterns table and content types section into separate reference files (e.g., references/anti-patterns.md, references/content-types.md) to reduce the main skill's token footprint and improve progressive disclosure.
The fabrication rule section makes its point effectively but restates the core message ('don't make things up / it's a trust problem') at least 3-4 times — consolidate to reduce redundancy while keeping the emphasis.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is well-written and most content earns its place, but it's quite long (~2000+ words) with some sections that could be tightened. The anti-patterns table is extensive and some entries feel redundant (e.g., multiple 'just say the thing' variants). The fabrication rule section, while important, repeats its core point multiple times. However, it avoids explaining things Claude already knows and stays focused on Joel-specific patterns. | 2 / 3 |
Actionability | Highly actionable throughout — provides specific examples from Joel's actual corpus (opening hooks, profanity usage, bold formatting), concrete do/don't pairs with ✅/❌ markers, a detailed anti-patterns table with exact replacements, and a publishable voice calibration checklist. Every rule is illustrated with real examples rather than abstract descriptions. | 3 / 3 |
Workflow Clarity | For a writing style guide (not a multi-step technical process), the workflow is exceptionally clear. The voice calibration checklist at the end serves as an explicit validation step. The fabrication rule section provides a clear decision tree (what counts as fabrication → what to do instead). Content types section gives clear structural patterns for each post type. The sequential logic of 'write → check voice → check fabrication → publish' is implicit but unambiguous. | 3 / 3 |
Progressive Disclosure | The skill references [references/voice-examples.md](references/voice-examples.md) for curated voice examples, which is good progressive disclosure. However, no bundle files were provided, so we can't verify this reference exists. The skill itself is quite long and some sections (like the extensive anti-patterns table or the content types section) could potentially be split into separate reference files. The overall organization with clear headers is good, but the monolithic length works against ideal progressive disclosure. | 2 / 3 |
Total | 10 / 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.