⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

claude-bionify

abullard1@abullard1⭐ 21 stars· last commit 1mo ago· 0 open issues

Configure and control the claude-bionify bionic reading plugin. Use when the user asks about bionic reading settings (fixation/strength, boundary, minimum word length, acronyms, URLs, headings), wants to turn the bionic display on, off, or toggle it, asks for the current status, or asks how to use the /claude-bionify commands.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

β€”/10

// RATINGS

⭐GitHub Stars
⭐⭐ 21 on GitHubGitHub β†—

Growing

🟒ProSkills Score
β€”
πŸ“

Not yet listed on ClawHub or SkillsMP

// README

License: MIT Claude Code Python Version CI Buy Me a Coffee


claude-bionify bolds the leading part of each word in Claude's streamed replies, giving your eye a fixation point per word. This is the bionic-reading technique, inspired by the eye-movement research showing that we read by fixating a single convenient position toward the start of each word, where its opening letters carry the most information for recognising it (Rayner, 1979; O'Regan et al., 1984).

It only changes how text looks on screen. What gets saved to the transcript and what Claude reads stays the original, unbolded text, which you can reopen any time with the Ctrl+O transcript view.

Features

  • ⚑ Faster, calmer reading. Fixation points pull your eye word to word through long answers.
  • 🌍 Any language. Unicode-aware, so accents and non-Latin scripts bold correctly, not just English.
  • 🎚️ Three boundary modes. fraction, syllable, or log β€” see Configure.
  • 🧩 Markup-aware. Code, links, URLs, paths, and acronyms stay intact (what it touches).
  • πŸ”’ Private, zero-dependency. Nothing to install, no network, no telemetry β€” it runs entirely on your machine.
  • πŸͺΆ Crash-safe. On any error it falls back to the original text.

Install

/plugin marketplace add abullard1/claude-bionify
/plugin install claude-bionify@claude-bionify

claude-bionify is active right away. Turn it off or back on any time with /claude-bionify:off and /claude-bionify:on, or from /plugin.

Configure

When you enable the plugin, Claude Code prompts for these (all optional):

SettingDefaultMeaning
Bold boundaryfractionfraction bolds by Fixation strength; syllable ends each word at its first syllable (e.g. string); log grows logarithmically so long words are bolded less.
Fixation strength0.5Fraction of each word to bold (0.1–0.9). Higher is bolder. Applies to fraction mode only.
Minimum word length4Words shorter than this are left unbolded.
Skip acronymsonLeave ALL-CAPS acronyms like API or JSON whole.
Protect URLs, paths, filesonDon't bold inside URLs, emails, file paths, or filenames.
Skip headingsonLeave markdown headings (# lines) unbolded; they're already prominent.

Control it live

Change claude-bionify mid-session without a reload or any config editing. The next reply reflects it right away:

CommandDoes
/claude-bionify:toggleFlip claude-bionify on/off
/claude-bionify:on Β· /claude-bionify:offTurn it on or off explicitly
/claude-bionify:set strength 0.7Set fixation strength (0.1–0.9)
/claude-bionify:set boundary syllableSwitch boundary (fraction Β· syllable Β· log)
/claude-bionify:set minlen 5 Β· /claude-bionify:set acronyms off Β· /claude-bionify:set urls off Β· /claude-bionify:set headings offTweak the other settings
/claude-bionify:statusShow the active overrides
/claude-bionify:resetClear overrides, back to your configured defaults

These write a small override file that the hook reads on every message, so changes take effect immediately and persist until you reset.

Themes

claude-bionify also ships seven color palettes for Claude Code's /theme picker (custom:claude-bionify:<name>). They retint Claude Code's interface and are independent of the bolding. Each one also tints diffs, the background behind your messages, and mouse selection in its own colors, and every text-on-background pair meets WCAG AA contrast (4.5:1; 3:1 for the changed-word highlight inside a diff line).

ThemeBaseTextAccentSubtleSuccessWarningError
Norddark#D8DEE9#88C0D0#4C566A#A3BE8C#EBCB8B#BF616A
Draculadark#F8F8F2#BD93F9#6272A4#50FA7B#F1FA8C#FF5555
Gruvboxdark#EBDBB2#FABD2F#928374#B8BB26#FE8019#FB4934
Solarized Darkdark#93A1A1#268BD2#586E75#859900#CB4B16#DC322F
Solarized Lightlight#586E75#268BD2#93A1A1#859900#CB4B16#DC322F
Sepialight#5C3C24#B58900#8A7E72#859900#CB4B16#DC322F
Focus Darkdark#ABB2BF#C678DD#4B5263#98C379#D19A66#E06C75

Plugin themes are read-only. Highlight one in /theme and press Ctrl+E to copy it into ~/.claude/themes/ and tweak your own.

How it works

Claude streams a reply β–Έ claude-bionify β–Έ bolded text in your terminal

As each batch of Claude's reply streams in, claude-bionify bolds it just before it reaches your screen β€” so only what you see changes, never the text itself.

What it touches

  • Bolded: ordinary prose words.
  • Left alone: inline `code`, fenced code blocks, markdown link/image targets, URLs, emails, file paths and filenames, ALL-CAPS acronyms, and any text Claude already wrapped in **bold**.
  • Never touched: your own input and tool output.

Requirements

  • Claude Code 2.1.152 or newer (the release that added the MessageDisplay hook)
  • Python 3.10+, reachable as python3 or through the py launcher (see below)
  • A terminal that renders markdown bold (any modern terminal)

On macOS, Linux, and WSL the hook runs as python3. Native Windows is different: the python.org installer creates python.exe and py.exe but no python3.exe, and Windows ships a Microsoft Store placeholder named python3.exe that exits without running Python. The hook therefore also launches through the py launcher.

Two consequences there. Bolding works, but the /claude-bionify:* commands do not, because they run through a shell where no fallback syntax suits both Git Bash and PowerShell; installing Git for Windows, or a real python3 on PATH, brings them back. And if your Python came from conda, uv, or pyenv-win, neither name may resolve, so point the hook at your interpreter with a MessageDisplay entry in ~/.claude/settings.json whose command is the absolute path to your python.exe.

If nothing looks bold but /claude-bionify:status reports ON, check the terminal before the plugin: ask Claude to write a plain **word** in a reply. If that is not bold either, the hook is not the problem. Windows Terminal has a per-profile Bold text style setting (intenseTextStyle in its settings.json) which on bright only shifts the foreground colour, invisible in schemes where the normal and bright variant

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • plugins/claude-bionify/skills/claude-bionify/SKILL.md4.8 KBupstream β†—
    ---
    name: claude-bionify
    description: Configure and control the claude-bionify bionic reading plugin. Use when the user asks about bionic reading settings (fixation/strength, boundary, minimum word length, acronyms, URLs, headings), wants to turn the bionic display on, off, or toggle it, asks for the current status, or asks how to use the /claude-bionify commands.
    when_to_use: User says things like "make bionify bolder", "turn off bionic reading", "set fixation to 0.7", "how do I change the minimum word length", "what bionify commands are there", or "reset bionify to defaults".
    user-invocable: false
    ---
    
    # claude-bionify control
    
    Background knowledge for answering questions about the claude-bionify plugin, which
    bolds the leading part of each word in Claude's responses (cosmetic bionic reading).
    Use it to recommend the right command and the exact key a user needs.
    
    ## Prerequisite: confirm the plugin is installed
    
    This skill is only useful when the **claude-bionify plugin** is installed. The skill and
    the plugin are separate: skill marketplaces can surface this `SKILL.md` on its own, so a
    user may have loaded the skill without the plugin that actually does the bolding. Without
    the plugin there is no `MessageDisplay` hook and no `/claude-bionify:*` commands, so every
    instruction below is inert.
    
    Before advising on settings or commands, verify the plugin is present:
    
    ```bash
    grep -q 'claude-bionify' ~/.claude/plugins/installed_plugins.json 2>/dev/null \
      && echo "plugin: installed" \
      || echo "plugin: MISSING"
    ```
    
    If the check fails (or the file does not exist), the plugin is not installed. Tell the
    user plainly that they have the skill but not the plugin, then give the two install steps
    and offer to run them:
    
    ```
    /plugin marketplace add abullard1/claude-bionify
    /plugin install claude-bionify@claude-bionify
    ```
    
    These are slash commands the user runs in Claude Code; you cannot invoke them yourself, so
    present them for the user to run (or paste) and confirm once bolding appears on the next
    response. Only continue with the settings and command guidance below once the plugin is
    confirmed installed.
    
    ## When to use
    
    Load this skill when the user wants to:
    
    - Change a setting (boldness, boundary, word length, acronyms, URLs, headings).
    - Turn the formatting on, off, or toggle it.
    - Check the current state or reset overrides.
    - Learn what `/claude-bionify` commands exist.
    
    ## Settings
    
    Each setting has a default in `plugin.json` and a short key used by the live
    `/claude-bionify:set` command. The set key is what you pass to the command, and it is
    shorter than the `plugin.json` field name.
    
    | Setting | `set` key | Default | Values | Meaning |
    | :-- | :-- | :-- | :-- | :-- |
    | Fixation strength | `fixation` (alias `strength`) | `0.5` | `0.1` to `0.9` | Fraction of each word bolded; higher is bolder. Applies to the `fraction` boundary only. |
    | Bold boundary | `boundary` | `fraction` | `fraction`, `syllable`, `log` | `fraction` uses the fixation strength; `syllable` bolds up to the first syllable; `log` grows logarithmically so long words are bolded less. |
    | Minimum word length | `minlen` | `4` | `1` or greater | Words shorter than this stay unbolded. |
    | Skip acronyms | `acronyms` | `true` | `on`, `off` | Leave ALL-CAPS acronyms such as API or JSON unbolded. |
    | Protect URLs, paths, files | `urls` | `true` | `on`, `off` | Do not bold inside URLs, emails, file paths, or filenames. |
    | Skip headings | `headings` | `true` | `on`, `off` | Leave markdown headings (lines starting with `#`) unbolded. |
    
    ## Commands
    
    All commands live under the `/claude-bionify` namespace.
    
    | Command | Argument | Action |
    | :-- | :-- | :-- |
    | `/claude-bionify:status` | none | Show the current settings and whether bionify is on. |
    | `/claude-bionify:on` | none | Enable bionic formatting. |
    | `/claude-bionify:off` | none | Disable bionic formatting. |
    | `/claude-bionify:toggle` | none | Flip bionify on or off. |
    | `/claude-bionify:set` | `<key> <value>` | Override one setting live. Keys: `fixation` (or `strength`), `boundary`, `minlen`, `acronyms`, `urls`, `headings`. |
    | `/claude-bionify:reset` | none | Clear live overrides and restore the `plugin.json` defaults. |
    
    Examples:
    
    - `/claude-bionify:set fixation 0.7`
    - `/claude-bionify:set boundary syllable`
    - `/claude-bionify:set minlen 5`
    - `/claude-bionify:set acronyms off`
    
    Important: `set` only accepts the short keys above, not the longer `plugin.json` field
    names. `set minlen 5` works; `set min_word_length 5` does not. Likewise use `acronyms`,
    `urls`, and `headings`, not `skip_acronyms`, `protect_urls`, or `skip_headings`.
    
    ## Notes
    
    - `set` changes apply to the next response and persist until `/claude-bionify:reset`.
    - Changing the `plugin.json` defaults instead takes effect on the next session.
    - The formatting is cosmetic: it never alters the underlying text Claude reads or saves.
    
  • README.mdupstream β†—

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/abullard1-claude-bionify-plugins-claude-bionify-skills-claude-bionify.md

// REPO STATS

21 stars
0 open issues
Last commit: 1mo ago