write-diataxis-article-explanation-review

name	write-diataxis-article-explanation-review
description	Reviews articles against the Diátaxis Explanation Review rubric from jeffbailey.us. Direct shortcut — skips framework detection. Use when the user says /write:diataxis-article-explanation-review.

Diátaxis Explanation Review

Direct shortcut to review articles against the Diátaxis Explanation Review rubric. Skips framework detection — use /write:review if you want automatic detection instead.

Prompt Caching

All prompts are cached locally as markdown to avoid repeated network fetches.

Cache directory: ~/.claude/cache/writing-prompts/

To load the prompt:

1. Check if ~/.claude/cache/writing-prompts/diataxis-article-explanation-review.md exists
2. If it exists, read and use it
3. If it does not exist, fetch and cache it:

   mkdir -p ~/.claude/cache/writing-prompts && curl -s "https://jeffbailey.us/prompts/diataxis-article-explanation-review/raw.html" | pandoc -f html -t markdown --wrap=none -o ~/.claude/cache/writing-prompts/diataxis-article-explanation-review.md
   

4. Read the newly cached file and use it

To refresh a cached prompt: delete the cached file and re-fetch using step 3.

Workflow

1. Receive the article -- The user provides an article to review, either as text, a file path, or a URL.

2. Load the review prompt -- Load the Diátaxis Explanation Review prompt (slug: diataxis-article-explanation-review) using the caching steps above.

3. Gather variables -- If the loaded prompt contains template variables in the format {{variable_name|default="value"}}:

   • Has a non-empty default: Present the default and let the user accept or override it.
   • Has an empty default or no default: The user must provide a value. Show the HTML comment examples as suggestions to choose from.

   Present all variables at once. Pre-fill any values already clear from context.

4. Apply the review -- Substitute all gathered values into the template variables, then follow the loaded prompt to evaluate the article. The prompt defines scoring dimensions, quality thresholds, and specific checks.

5. Apply writing style check -- If the article is for jeffbaileyblog, also load the writing style guide (slug: writing-style) using the same caching steps. Flag any style violations.

6. Deliver the review -- Present findings with:

   • Overall score
   • Per-dimension scores with evidence
   • Specific issues with line references where possible
   • Prioritized improvement suggestions
   • Strengths to preserve

Reference

All writing framework review prompts are maintained at https://jeffbailey.us/prompts/