Skip to content
Baseworks KB

Update Science Content — Skill Guidelines

Created 2026-03-26
Tags claude-codeskillssciencecontent

The /update-science-content skill updates or writes science-based web content for baseworks.com. It is designed for content where scientific accuracy and Baseworks method context must both be present — content that a general reader finds accessible and that a specialist would not find objectionable.

When to Use This Skill

Section titled “When to Use This Skill”

Use /update-science-content when:

  • A blog post or page has science content that predates current KB framing (e.g. written before the fusimotor reafference hypothesis was formalized, or before the Proske & Weber 2026 paper)
  • A page needs to be updated to reflect the three-component body awareness framework as it now stands in science.md
  • You are writing new science-based content from scratch and need the method context + accuracy layer baked in from the start
  • An existing post has framing that has drifted from the current Baseworks voice or scientific position

What the Skill Does

Section titled “What the Skill Does”

The skill works in nine steps, but the most important design principle is: it does not draft until you have had a genuine conversation about strategy.

Steps 3 through 6 are all about alignment before writing:

  • Step 3: your notes and priorities
  • Step 4: literature scan for recent papers
  • Step 5: structured assessment of what to keep, replace, move, and add
  • Step 6: conversation rounds — as many as needed before drafting

This is intentional. Science-based content at Baseworks sits at the intersection of method specificity, voice, and scientific defensibility. Getting the strategy right before drafting saves significant revision time.

Voice Guide Logic

Section titled “Voice Guide Logic”

The skill loads voice guides based on content type:

Content typeVoice guides loaded
Page on baseworks.comVOICE-GUIDE-UNIFIED.md
Asia’s article/blog postVOICE-GUIDE-UNIFIED.md + VOICE-GUIDE-KSENIA-ASIA.md

The skill always loads key-definitions.md and science.md — the method context is not optional.

The Dual-Audience Principle

Section titled “The Dual-Audience Principle”

Science content at Baseworks must serve two readers simultaneously:

  1. The general reader — someone who may not know what proprioception is, who follows the argument through clear prose and good examples, and who trusts the author because they explain things without being condescending
  2. The specialist — a neuroscientist, physiotherapist, or movement researcher who would notice a sloppy claim, an overclaim, or a missing citation

These are not in conflict. The way to serve both is: make the main text accessible, ground every specific claim in a citable source, use precise terminology without assuming the reader knows it, and be transparent about what is established vs. what is a working hypothesis.

The Method-Context Requirement

Section titled “The Method-Context Requirement”

The science in these articles is not background information. It is there to explain why Baseworks works and what it is doing. Every scientific claim should connect back to a specific method mechanism — a principle, a technique, a training approach. If a section of science could be copy-pasted into an article about any other movement practice, it has lost its purpose.

The skill loads key-definitions.md to maintain this connection throughout drafting.

Archiving Old Copy

Section titled “Archiving Old Copy”

When rewriting existing content, the skill archives the old version before any work begins. This serves two purposes:

  1. Translation reference — the Japanese translation of any updated post needs to be updated against the original source. The archive is that source.
  2. Historical record — useful for understanding how the framing has evolved.

Archive files go to _archive/ within the relevant content folder (e.g. 02-areas/website/blog-articles/_archive/). They receive:

  • no_embed: true — hidden from QMD search embedding
  • archived: YYYY-MM-DD
  • archive-reason — pointing to the new version
  • translation-note — flagging that the Japanese translation needs updating against this file

The _rework/ folder is for working drafts during an active session only. Once the new version is finalized and the archive exists, the _rework/ file is deleted.

Content Routing

Section titled “Content Routing”

Content that gets cut from one post does not have to disappear. The skill flags displaced content and routes it:

  • Injury-prevention framing → the Injury Prevention page
  • Overly technical mechanism details → internal vault notes or footnotes
  • Data from the muscle sensations questionnaire → a future dedicated post, or the science-docs area

Source Material in the Vault

Section titled “Source Material in the Vault”

Key files this skill draws from:

  • science — current scientific framing, the ground truth for all claims
  • key-definitions — Baseworks terminology and method concepts
  • 03-resources/voice-guides/VOICE-GUIDE-UNIFIED.md — core Baseworks voice
  • 03-resources/voice-guides/VOICE-GUIDE-KSENIA-ASIA.md — Asia’s writing voice
  • 02-areas/website/blog-articles/_rework/ — posts staged for update
Section titled “Related”