Article Craft An Assay guide for technical writers

Every request?

A release note says the cache halved response time for every request. Switch between timed and untimed requests. What can you actually publish?

Try the marked-up article
Fictional cache replay80 requests
Which requests do you want to inspect?
20of 80
Warm requestsMedian with cache off 96 msMedian with cache on 48 ms
60of 80
Cold requestsThe replay recorded no response times for this group.

One slot per request. Filled slots show the selected group.

Mark up the claim.

Article Craft checks “every” against the replay. Prose Cadence gives the comparison its own sentence. Humanizer checks the last line against the writer’s voice.

Original draft

In this replay of 80 requests, the preview cache halved response time for every request. Turn it on for the next busy shift.

Evidence edit

In this replay of 80 requests, deleted wording: the preview cache halved response time for every request. replacement wording: the 20 warm requests had a median response time of 96 ms with the preview cache off and 48 ms with it on, while the 60 cold requests went untimed. deleted recommendation: Turn it on for the next busy shift.

Cadence pass

The replay covered 80 requests. For the 20 warm ones, median response time was 96 ms with the preview cache off, 48 ms with it on. The 60 cold requests went untimed.

Voice pass

The replay covered 80 requests. For the 20 warm ones, median response time was 96 ms with the preview cache off, 48 ms with it on. Previous wording: The 60 cold requests went untimed. Revised wording: The record has no timings for the 60 cold requests.

Source note

In this fictional replay, 20 warm requests had a median of 96 ms with the cache off and 48 ms with it on. The other 60 requests were cold and untimed. The test collected no error rates or page-load times.

Use the skills on your draft.

Start with your draft and the notes behind it. Check the claim first. Once it holds, listen to how it reads.

Article Craft

Who will act on this sentence? Name that reader. Article Craft checks the draft against its sources and finds the smallest edit that makes the claim hold.

Try this prompt

Use article-craft to review draft.md against notes.md. My reader is an on-call engineer deciding whether to enable the cache. Identify the claim with the weakest support and suggest the smallest edit that repairs it.
Read the skill

Prose Cadence

Read the verified paragraph aloud. If the caveat disappears halfway through a long sentence, give Prose Cadence the passage and ask it to find the pause.

Try this prompt

Use prose-cadence on the verified results paragraph in draft.md. Give the comparison room to land. Return the revised paragraph and identify any change to attribution, scope, or uncertainty.
Read the skill

Humanizer

Pick a paragraph from a similar article you wrote. Give it to Humanizer with your draft. A phrase worth keeping might be the one that sounds most like you.

Try this prompt

Use humanizer on the results paragraph in draft.md. Use sample.md as my voice sample. Show one edit you would make and one phrase you would keep. Preserve the measurements and who we can say did what.
Read the skill

Which article are you writing?

The same evidence can support different articles. Pick the shape that answers your reader’s question.

Incident or method

What exposed the fault?

Start with the symptom, reconstruct the sequence, and show the check that distinguished two possible causes.

Technical explainer

Can the reader predict what happens next?

Follow one input through the mechanism. Change one condition and ask the reader to predict the new output.

Thought leadership

When would the alternative win?

State a position a reader could reasonably dispute. Give its strongest alternative and the evidence that could change your mind.

Tooling update

Should the reader adopt this change?

Demonstrate the change on a real task. Give availability, prerequisites, migration cost, and what a current user will notice.

How-to

Can the reader verify the result?

Specify the starting state. Pair each action with its expected observation and run the whole path before calling it verified.

Bench report

Which choice wins on this workload?

Name the baseline, population, measures, and selection criteria. Show the condition that could reverse your recommendation.

Research note

What would count against the idea?

Separate the prior result, proposed mechanism, evidence so far, and open question. Describe an observation that would challenge the hypothesis.

Install the skills.

Choose your writing tool for the standalone Editorial plugin. Look for editorial in the Assay catalog. If your catalog does not list it yet, open the project download in your tab.

Claude Code

Run these two commands in your terminal.

claude plugin marketplace add medici-finance/assay
claude plugin install editorial@assay

Open your draft

Start a new Claude Code session in your writing project. Type /editorial:article-craft to edit a claim, /editorial:prose-cadence to revise its rhythm, or /editorial:humanizer to match a writing sample.

Give the skill your draft and the source notes you checked it against.

Install the three skills in this project

Save the three-skill archive in your project root. From that directory, run these commands in a macOS, Linux or Git Bash terminal.

mkdir -p .claude/skills
tar -xkf article-craft-skills.tgz -C .claude/skills

Use the project copy

In a new Claude Code session, use /article-craft, /prose-cadence, or /humanizer.

Extraction keeps existing files. On a repeat install, GNU tar reports “File exists” and exits with an error. Compare those files before updating them.

Codex

Run these two commands in your terminal.

codex plugin marketplace add medici-finance/assay
codex plugin add editorial@assay

Open your draft

Start a new Codex session in your writing project. Type $editorial:article-craft to edit a claim, $editorial:prose-cadence to revise its rhythm, or $editorial:humanizer to match a writing sample.

Give the skill your draft and the source notes you checked it against.

Install the three skills in this project

Save the three-skill archive in your project root. From that directory, run these commands in a macOS, Linux or Git Bash terminal.

mkdir -p .agents/skills
tar -xkf article-craft-skills.tgz -C .agents/skills

Use the project copy

In a new Codex session, use $article-craft, $prose-cadence, or $humanizer.

Extraction keeps existing files. On a repeat install, GNU tar reports “File exists” and exits with an error. Compare those files before updating them.

Cursor

On Teams or Enterprise, a team admin can import the Assay repository.

  1. In the Cursor dashboard, open Plugins & MCPs. Under Team Marketplaces, choose Add Marketplace, then Import from Repo.
  2. Enter the repository URL below and track main. Select editorial and give your team access. If the repository is already connected, refresh the marketplace to see new plugins.
https://github.com/medici-finance/assay

Cursor’s team marketplace instructions

Open your draft

Open Customize in the Cursor sidebar and find editorial in your team marketplace. Install it if your team has made it optional. In a fresh Agent chat, ask for article-craft, prose-cadence, or humanizer by name.

Give the skill your draft and the source notes you checked it against.

Install the three skills in this project

Save the three-skill archive in your project root. From that directory, run these commands in a macOS, Linux or Git Bash terminal.

mkdir -p .cursor/skills
tar -xkf article-craft-skills.tgz -C .cursor/skills

Use the project copy

Open a new Agent chat in the project. Type / and choose article-craft, prose-cadence, or humanizer.

Extraction keeps existing files. On a repeat install, GNU tar reports “File exists” and exits with an error. Compare those files before updating them.

Assay marketplace setup Archive source at 87a211a