joel-writing-style
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.
89
87%
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 term coverage and completeness. It clearly defines its niche (Joel's personal writing voice for a specific website) and provides explicit guidance on when to use it, including natural user phrases. The main weakness is that the specificity of capabilities could be improved by listing concrete style characteristics rather than just the general actions of writing/editing/reviewing.
Suggestions
Add 2-3 specific style characteristics to improve specificity, e.g., 'Applies Joel's conversational tone, short-paragraph structure, and first-person narrative style' to give Claude more concrete understanding of what the skill actually does.
| 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, sentence structure patterns, or vocabulary preferences that make the style guide actionable. | 2 / 3 |
Completeness | Clearly answers both 'what' (Joel's writing voice and style guide for joelclaw.com content, capturing specific writing patterns from ~90,000 words) 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 users would say: '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 highly natural phrases a user would actually use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive — it's specifically about Joel's personal writing voice for joelclaw.com, which is a unique niche unlikely to conflict with other skills. The cross-reference to copy-editing and copywriting skills further clarifies boundaries. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%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, well-crafted voice/style guide that provides highly actionable guidance with abundant concrete examples from the actual corpus. Its main weakness is moderate verbosity — the anti-patterns table and fabrication section could be tightened without losing clarity. The progressive disclosure and workflow are excellent, with a clear calibration checklist serving as a validation checkpoint.
Suggestions
Consolidate the anti-patterns table — many entries follow the same pattern ('remove unnecessary intensifiers/qualifiers') and could be grouped into a single rule with 3-4 examples instead of 15+ individual rows.
The fabrication rule section makes the same core point ('don't invent things, flag gaps with TODOs') at least 4 times across sub-sections; condense to a single clear statement with the examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is thorough and mostly earns its length given the complexity of capturing a specific person's voice, but there's notable verbosity — the anti-patterns table is extensive with many entries that could be condensed, and some sections (like the fabrication rule) repeat the same point multiple times. The explanatory framing ('This guide is derived from analyzing 127 posts') and some philosophical DNA descriptions could be tighter. | 2 / 3 |
Actionability | Highly actionable throughout — concrete examples with ✅/❌ patterns, specific corpus quotes showing what good looks like, a detailed anti-patterns table with exact substitutions, and a voice calibration checklist. Claude can directly apply every rule with the examples provided. | 3 / 3 |
Workflow Clarity | The skill has a clear workflow: core voice rules → structural patterns → philosophical DNA → fabrication rules → anti-patterns → content types → voice calibration checklist. The checklist at the end serves as an explicit validation step before publishing, and the fabrication rule section includes clear decision trees for what to do when uncertain. | 3 / 3 |
Progressive Disclosure | Well-structured with clear sections and a single one-level-deep reference to 'references/voice-examples.md' for curated examples. The main document serves as a comprehensive but navigable overview, with content appropriately organized under descriptive headers. No nested reference chains. | 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
ce9ca8e
- 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.