sb-author

Stable Baseline: author documents

What this skill does

Creates and edits living documents in CDMD, a Markdown superset, and brings external files in as documents. Every change runs under the signed in user's own Stable Baseline identity and inherits their exact permissions.

IDs are never hardcoded. Resolve projectId, folderId and documentId at runtime from listing calls made in this conversation.

Before you write anything

1. Resolve scope. listOrganisations, listWorkspaces, listProjects. If several workspaces or projects are accessible, ask which one. Never guess where a document should live.
2. Check whether it already exists. Run listDocuments with a query before creating. Duplicating an existing document is a common and annoying failure. If a close match exists, show it and ask whether to edit that or create a new one.
3. Learn the format once per session. Call getCdmdLanguageGuide before your first create or edit if you have not already. CDMD is not plain Markdown and guessing the block syntax produces broken documents.

Creating a document

createDocument requires projectId. It also accepts folderId, title, cdmd, position and changeSummary.

• Always set a meaningful title.
• Always set changeSummary. It appears in version history and is how colleagues understand what an agent did.
• Place it deliberately. Ask for the folder if the project has several and the user has not said. createFolder, updateFolder, listFolders and getFolderHierarchy manage the tree; reorderDocuments and reorderFolders change display order.

Editing a document

editDocument is the preferred tool for targeted changes. It requires documentId and supports two patch dialects that must not be mixed in one call.

Anchor patches, recommended. {oldText, newText, before?, after?}.

• oldText must match the document byte for byte and be unique.
• If it occurs more than once, expand oldText until unique, or add before or after with the exact adjacent text.
• A no-match returns nearby context. An ambiguous match returns the occurrence count. Read the error and fix the anchor rather than retrying blindly.
• newText: "" deletes the anchored text.
• Anchors do not drift and survive concurrent edits, so no fresh line numbers are needed.
• The text field in listDocuments contentMatches is anchor-ready. Paste it straight in as oldText.