Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Writing Beats · evgeniiperov | DecimalAI

documentationby evgeniiperov

Writing Beats

evgeniiperov/writing-beats

Source evgeniiperov/quay ↗License MIT

Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end.

SkillScore55Maintained

Automatic

Writing & Editing pack

Last verified 8/6/2026

What it changes

Passed 11 of 20 test cases with the skill, and 10 of 20 without it.

Without skill50%

With skill55%

Checks it passed that the model alone missed

Offers 2 to 3 options for Beat 4
Asks the user where to save the destination article file
Recommends splitting the proposed section into multiple distinct beats

and 1 more in the full report

4 fixed8 passed either way7 still failing3 broke

Pass-rate lift: +5 pp
Tokens: +15%
Agent turns: 0%
Response time: -21%

Model gemini-3.6-flashMeasured 8/6/2026v112 of 22 cases passed with skill · 20 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/evgeniiperov-writing-beats/SKILL.md https://app.decimal.ai/s/evgeniiperov-writing-beats/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add evgeniiperov-writing-beats, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/evgeniiperov-writing-beats/ and pins it in .decimal/skills.lock

decimalai skills add evgeniiperov-writing-beats

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/evgeniiperov-writing-beats/SKILL.md https://app.decimal.ai/s/evgeniiperov-writing-beats/SKILL.md

Raw file: /s/evgeniiperov-writing-beats/SKILL.md ↗ · machine-readable summary at /s/evgeniiperov-writing-beats.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 4 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 4

Prompt

Here are my notes on urban gardening in `gardening.md`. Let's build an article step by step starting with 2-3 opening options.

What was checked, without and with the skill
Checked	Without skill	With skill
Asks the user where to save the destination article file	Missed	Passed

case-02 · gemini-3.6-flash · 8/6/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md47 linessingle file

The user has passed (or will pass) a markdown file of raw material.

If the user did not say where to save the article, ask once and remember the path.

Then run a beat-by-beat journey:

Write 2–3 candidate starting beats, drawn from the raw material. Each is a different entry point into the article. Show the user the beats before writing it to the article file. The user picks one. Preview what beats that might lead to once written - as if the user is seeing a little way down the path.
Once the user picks a starting beat, write only that beat to the article file. A beat may be one sentence or several paragraphs — whatever that beat naturally is. Stop there.
Re-read the article file from disk. Then offer 2–3 candidate next beats — different directions the journey could pivot to from where the article now stands.
Loop steps 2–4 until the article reaches a natural end.

What is a beat

A beat is one move in the journey. It does one thing — sets a scene, lands a point, asks a question, drops an aside, twists the angle. Then it stops, leaving the reader at a place where the next beat can pivot.

A beat is sized by what it needs:

A single sentence if that's all the move is ("And then nothing happened for three weeks.").
A short paragraph if the move needs setup.
Multiple paragraphs if the beat is a self-contained vignette, argument, or example.

If a "beat" needs five paragraphs and three subheadings, it's not a beat — it's two beats glued together. Split it.

Writing one beat

Once a beat is picked, write that beat only to the article file. Do not write the next beat.

Pull material from the raw pile to populate the beat. You can paraphrase, split, recombine, or quote. The pile is a quarry.

Ending the journey

The article ends when the journey is complete — not when the pile is empty. Most piles will have leftover fragments that don't make it in. That is fine; that is the point of having more raw material than you need.

Writing rhythm

Track record

Benchmark

11 / 20

test cases passed, vs 10 / 20 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/2/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

evgeniiperov / quay

.agents/skills/writing-beats/SKILL.md

View on GitHub ↗

License MITImported 8/2/2026Version v1

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

More skills from the same source and nearby in the registry, with their headline benchmark lift.