Agent skill

Writing Beats

by InditexTech in InditexTech/weavejs

Shape an article as a journey of beats, choose-your-own-adventure style.

Apache-2.0Auto-check passed

Install Writing Beats

skills CLI
$ npx skills add InditexTech/weavejs --skill writing-beats -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install InditexTech/weavejs writing-beats --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/InditexTech/weavejs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/writing-beats .claude/skills/writing-beats && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
writing-beats
GitHub stars
208
Used in
3 other repos
Token cost
~705 tokens
SKILL.md length
425 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

Shape an article as a journey of beats, choose-your-own-adventure style.

  • Works in 4 steps: Write 2–3 candidate starting beats,… → Once the user picks a starting beat,… → Re-read the article file from disk. Then… → …
  • The user has raw material and wants to assemble it as a narrative rather than an argument
  • SKILL.md covers What is a beat, Writing one beat, Ending the journey and Writing rhythm
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Beats is an agent skill from InditexTech/weavejs. 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. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Weave.js is an open source library to build real-time collaboration applications like whiteboards, diagram editors, etc. on HTML5 Canvas with your own UI. The licence is Apache-2.0.

When your agent uses it

  • The user has raw material and wants to assemble it as a narrative rather than an argument

Example prompts

  • “/writing-beats”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 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…
  2. 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…
  3. Re-read the article file from disk. Then offer 2–3 candidate next beats — different directions the journey could pivot to from where the…
  4. Loop steps 2–4 until the article reaches a natural end.

What it can do on your machine

Read from SKILL.md and the folder at commit 2bd3672. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Writing Beats loads about 705 tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 425 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~91
When it runs · the whole SKILL.md, loaded when a task matches
~705

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from InditexTech/weavejs at commit 2bd3672, republished under its Apache-2.0 licence (© InditexTech). 425 words, ~705 tokens.

Download SKILL.mdSave it as .claude/skills/writing-beats/SKILL.md (or your agent's skills folder).
name
writing-beats
description
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. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.
<what-to-do>

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:

  1. 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.
  2. 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.
  3. 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.
  4. Loop steps 2–4 until the article reaches a natural end.
</what-to-do>
<supporting-info>

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.

Show full SKILL.md (151 more words)Show less

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

  • Append one beat at a time. Never write ahead.
  • Re-read the article file from disk before every write. Preserve user edits absolutely.
  • If the user edits a previous beat substantially, let it change what comes next.
  • If the user says "rewrite that beat" or "go back and try a different beat 3", do it — edit in place, leave the rest alone.
</supporting-info>

© InditexTech, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/writing-beats of InditexTech/weavejs.

Open the folder on GitHubat commit 2bd3672

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in InditexTech/weavejs, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Writing Beats next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Writing Beats compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Beats this skillInditexTech/weavejs2083 repos~705Automated safety check: PassApache-2.0
Articlethedaviddias/Front-End-Checklist74k—~421Automated safety check: PassMIT
Article Magazinenexu-io/open-design100k—~495Automated safety check: PassApache-2.0
Article Linksthedaviddias/Front-End-Checklist74k—~425Automated safety check: PassMIT
Customer Journey Mapphuryn/pm-skills27k—~816Automated safety check: PassMIT
Article Writingaffaan-m/ECC275k3 repos~295Automated safety check: PassMIT

Similar skills

  • Article

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Implement valid Article structured data.

    74k GitHub stars~421 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Article Magazine

    nexu-io/open-design

    Huashu / huashu-md-html-inspired magazine article layout for turning Markdown or notes into a polished long-form HTML essay.

    100k GitHub stars~495 tokensUpdated today
    Documents & OfficeAuto-check passed
  • Article Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing metadata, crawlability, structured data, or indexability related to Optimize article link density.

    74k GitHub stars~425 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Customer Journey Map

    phuryn/pm-skills

    Create an end-to-end customer journey map with stages, touchpoints, emotions, pain points, and opportunities.

    27k GitHub stars~816 tokensUpdated 23 days ago
    Product & Project ManagementAuto-check passed
  • Article Writing

    affaan-m/ECC

    根据提供的示例或品牌指导,以独特的语气撰写文章、指南、博客帖子、教程、新闻简报等长篇内容。当用户需要超过一段的精致书面内容时使用,尤其是当语气一致性、结构和可信度至关重要时。

    275k GitHub starsUsed in 3 repos~295 tokens
    Writing & ContentAuto-check passed
  • Article Writing

    affaan-m/ECC

    記事、ガイド、ブログ投稿、チュートリアル、ニュースレター号、その他の長文コンテンツを、提供された例またはブランドガイダンスから派生した独特の声で作成します。ユーザーが段落より長いポーランド済みの書き込みコンテンツを望む場合、特に声の一貫性、構造、および信頼性が重要な場合に使用します。

    275k GitHub stars~385 tokensUpdated 3 days ago
    Writing & ContentAuto-check passed

More from InditexTech/weavejs

All 9 skills in this repo
  • Writing Fragments

    InditexTech/weavejs

    Grilling session that mines the user for fragments — heterogeneous nuggets of writing (claims, vignettes, sharp sentences, half-thoughts) — and appends them to a single document as raw material for…

    208 GitHub starsUsed in 4 repos~828 tokens
    Auto-check: warnings
  • Docouture Authoring Guides

    InditexTech/weavejs

    What to write on each page of a docouture documentation site: the purpose of every page, the section skeleton it needs, what to say in each section, a copyable AsciiDoc starting point and a quality…

    208 GitHub stars~3.9k tokensUpdated 3 days ago
    Auto-check passed
  • Writing Shape

    InditexTech/weavejs

    Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format…

    208 GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • Docouture Docs Internals

    InditexTech/weavejs

    How a docouture Antora documentation site is put together: the playbook, the docs/antora.yml component descriptor, the four names that must agree, the ROOT+main default layout, promoting…

    208 GitHub stars~1k tokensUpdated 3 days ago
    Auto-check passed
  • Docouture Writing Docs Pages

    InditexTech/weavejs

    How to author AsciiDoc content in a docouture Antora documentation site — the content tree, xref: references, nav.adoc, admonitions, code blocks, and this site's own custom blocks (tabs, cards…

    208 GitHub stars~3.1k tokensUpdated 3 days ago
    Auto-check passed
  • How to update an existing docouture documentation site when a feature, change, deprecation or fix lands in the repo — figuring out what's affected from a diff/commit/PR, confirming with the user…

    208 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed

Questions about Writing Beats

What does Writing Beats do?

Shape an article as a journey of beats, choose-your-own-adventure style. Writing Beats is an agent skill from InditexTech/weavejs. Shape an article as a journey of beats, choose-your-own-adventure style.

When should I use Writing Beats?

Writing Beats fits situations like: the user has raw material and wants to assemble it as a narrative rather than an argument.

How do I install Writing Beats in Claude Code?

Run `npx skills add InditexTech/weavejs --skill writing-beats -a claude-code`. Or copy the skill folder (.agents/skills/writing-beats in InditexTech/weavejs) into .claude/skills/writing-beats in your project. Claude Code loads it when a task matches its description.

How do I install Writing Beats in Codex?

Run `npx skills add InditexTech/weavejs --skill writing-beats -a codex`. Or copy the skill folder (.agents/skills/writing-beats in InditexTech/weavejs) into .agents/skills/writing-beats in your project. Codex loads it when a task matches its description.

Can I use Writing Beats in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add InditexTech/weavejs --skill writing-beats -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-beats, .gemini/skills/writing-beats, .github/skills/writing-beats and .opencode/skills/writing-beats in your project.

What does Writing Beats need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Beats is instructions for the agent only.

Does Writing Beats access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Writing Beats safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Beats use?

Writing Beats is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Writing Beats use?

About 705 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Beats?

Skills that share tags, products or a category with Writing Beats: Article (thedaviddias/Front-End-Checklist, 74k stars), Article Magazine (nexu-io/open-design, 100k stars), Article Links (thedaviddias/Front-End-Checklist, 74k stars) and Customer Journey Map (phuryn/pm-skills, 27k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Beats?

InditexTech (a GitHub organization) maintains it in InditexTech/weavejs, which has 208 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 5, 2026.

Source: InditexTech/weavejs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.