CLI + macOS desktop
Skryba documentation
Learn the rewrite pipeline from first score to selected text, then inspect every command, concept, workflow, trust boundary, and failure mode.
Start here
CLI reference
CLI referenceThe complete command tree, global options, input rules, and output contracts.skryba onboardingThe first-use walkthrough, completed by the first draft import.skryba draftImport and retain an existing source document.skryba scoreMeasure detector AI probabilities for one text.skryba corpusVerify and sample a curated corpus offline.skryba rewriteGenerate, judge, score, and select a rewrite.skryba style and languageThe styles and output languages a rewrite can require, and how to add one.skryba benchmarkEvaluate rewrite quality on documentation or a corpus.skryba trainOptimize the native rewrite-strategy policy with GRPO.skryba writing-styleHold the writer's own prose, measure it, and export it for Ster.skryba writing-style samplesWork out which samples to rewrite so the adapter learns your style, and write them.skryba writing-style harvestCollect your writing from folders, Messages, Notes and transcripts on a schedule.Writing-style learningNext author work, training provenance, held-out comparison and progress.skryba ruleWriting rules on sentence and word length, paragraph shape, lists and phrases.skryba lyricsLyric forms, counted syllables and rhymes, and composing lyrics that meet a form.skryba databaseThe fleet database every Skryba store lives in, and how to check it.Train, benchmark, and corpusTrain strategy policy, benchmark quality, and verify curated samples.ConfigurationModels, detectors, credentials, cache, and endpoint overrides.ExamplesRunnable examples shipped with the CLI repository.CLI runbookSymptom-first diagnosis for model, detector, cache, and workflow failures.
Concepts
RewriteChunked candidate generation and selection.ScoreEnsemble AI probability and detector evidence.ChunkHow long inputs become bounded rewrite units.DetectorProvider adapters, score normalization, and ensemble behavior.Quality judgeMeaning preservation, critical errors, and thresholding.Detector cacheRevision-aware score reuse and billing protection.Strategy policySampling, GRPO training, and policy files.Credential boundaryWhich component receives each credential.Writing-style storeWhat the store keeps, why it keeps text, and how it deduplicates.Training boundarySkryba drives Ster; Ster owns the weights and the gradient.Sample planLength bands, strata and the share of pairs each kind of writing gets.Writing rulesWhat each metric counts, and how a rule's value comes from your profile.Lyric formHow syllables and rhymes are counted from sound, refused endings, and the compose loop.
Walkthroughs
Walkthrough: scoringRead an ensemble result from input to evidence.Walkthrough: offline rewriteExercise selection behavior without live providers.Walkthrough: transcriptsImport your own prose from session transcripts into the writing-style store.Walkthrough: writing styleIngest real prose, export it, and train a LoRA adapter in Ster.Walkthrough: local generatorRun --generator local end to end: real ster generate, one process per candidate, and the defects that found.CLI architectureModules, data flow, ownership, and trust boundaries.
Desktop
What is Skryba Desktop?The native macOS process client and its mental model.Desktop quick startInstall the CLI, configure Finder launches, and run the app.Desktop Import workflowChoose, retain, and reopen a real source document.Desktop Score workflowInput, invocation, result, and failure behavior.Desktop Rewrite workflowControls and rendered candidate evidence.Desktop Styles & languages workflowList, add, change, and remove the catalog the Rewrite pickers offer.Desktop Writing style workflowIngest, export, status, and the Keep-mine capture.Desktop Your voice workflowSamples, automatic import, writing assignments, rules, progress and held-out evaluation.Desktop Evaluate & train workflowVerify a corpus, benchmark, train the strategy policy, and check the database.Desktop Lyrics workflowKeep lyric forms, check lyrics and compose in a form from the window.Desktop spawn contractExecutable search, process I/O, and compatibility.Desktop configurationEnvironment merge rules and build-time variables.Desktop runbookSeparate form, spawn, CLI, and decoding failures.Desktop architectureSwiftUI components and the CLI trust boundary.