writing-beats — Claude Code skill: what it does, how to install
writing-beats is a Claude Code skill that shapes a raw-material file into an article, one selected beat at a time. The user chooses the opening and each next direction.
AGPL-3.0 ★ 88 updated 2026-11-17
npx skills add alexj11324/Mikka --skill writing-beats -a claude-codeWhat writing-beats does
writing-beats turns source notes into a sequence of article beats. The agent first establishes what the intended audience already understands, then offers opening options and previews where each path could lead. The user picks one; the agent writes only that beat to the article file.
After each addition, the agent reads the file again and suggests next beats that fit the concepts already introduced. Each option names the concepts it would establish. If no save location was given, the agent asks once. Before every write, it rereads the file so user edits remain intact.
What it helps with
- turn a file of raw notes into an article
- introduce concepts before later passages rely on them
- choose between possible directions for an article
- write an article incrementally while keeping file edits
Example prompts for the agent
- Turn this Markdown file of notes into an article, offering opening and continuation options.
- Help structure the article around its concepts: establish what the audience knows, then write one beat at a time.
- Continue the article from its file: reread the current text and suggest reachable next beats.
How to install writing-beats
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-beats -a claude-code2Manually: put the files in place
~/.claude/skills/writing-beats/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/writing-beats/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-beats -a codex2Manually: put the files in place
.agents/skills/writing-beats/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-beats -a cursor2Manually: put the files in place
.cursor/skills/writing-beats/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install alexj11324/Mikka .claude/skills/writing-beats2Manually: put the files in place
.github/skills/writing-beats/SKILL.md1Skills CLI (Vercel)
npx skills add alexj11324/Mikka --skill writing-beats -a gemini-cli2Platform CLI
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/writing-beatsManually: put the files in place
.devin/skills/writing-beats/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about writing-beats
How do I install writing-beats in Claude Code?
Run npx skills add alexj11324/Mikka --skill writing-beats -a claude-code. The skill file is located at ~/.claude/skills/writing-beats/SKILL.md.
What does writing-beats do?
It helps turn source material into an article through a sequence of user-selected passages. Each proposed passage must rely on concepts the audience already knows or that an earlier passage has explained.
How does writing-beats handle edits to the article file?
Before each write, the agent rereads the article from disk and retains user changes. It adds only the selected beat at that step.