Playbooks
-
Build, preview and edit the website edited since a person last confirmed it (confirmed 2026-10-13, edited 2026-10-26), reopened
How the project website inwebsite/is built with Astro Starlight from the README,docs/, the knowledge bundle,CHANGELOG.mdand, when shown, the LinkML schema’s pages and data; how to preview it locally with npm and uv; which file to edit for each kind of change; and howknowledge-website.yamlpublishes it to GitHub Pages, on a push, weekly or by hand. -
Contributing checked by automation only, still a draft
How to work on the skills: no build step but the website’s, the local checks to run before opening a pull request, the role boundary a change must respect, and which pages now hold the release and signing detail. -
Curating a domain bundle checked by automation only, still a draft
How the curator of a domain host confirms that a bundle belongs, what the domain’s four concept types hold, what moves a member, and how to read the workspace the domain’s releases build. -
Knowledge outside the repository checked by automation only, still a draft
How the ingest mirrors Confluence pages, web pages and PDFs, files in another git repository and a command’s output into.lokf/mirror/, with the manifest.lokf/ingest.yaml, the lock, sensitivity, the weekly pull request, and how the librarian cites a mirror file. -
Knowledge sources edited since a person last confirmed it (confirmed 2026-10-13, edited 2026-10-28), reopened 2026-10-27 by noelmcloughlin: 1 question waits
Map of the repository locations this bundle was derived from, and how to re-check each on a future refresh. -
ktl-curator skill edited since a person last confirmed it (confirmed 2026-10-13, edited 2026-10-29), reopened 2026-10-29 by noelmcloughlin: 1 question waits
A human curator’s assistant: a one-screen report of what needs a person’s attention, then a review session that records that person’s confirm, correct, retire or send-back verdicts in the bundle’s frontmatter, including on a domain host’s member concepts. -
ktl-docent skill edited since a person last confirmed it (confirmed 2026-10-13, edited 2026-10-29), reopened
The reader’s side: it answers questions from the bundle first, with each concept’s trust label, falls back to the repository when the bundle cannot answer, and records misses and disagreements for the librarian; it also answers for younger readers and from a domain host’s workspace. -
ktl-librarian skill edited since a person last confirmed it (confirmed 2026-10-13, edited 2026-10-29), reopened
Recurring procedure that scrapes the host repository, derives and maintains the .lokf/ concepts and their typed relations, audits the bundle, and hands off for human review. -
ktl-prose skill checked by automation only, still a draft
The librarian’s copy editor. It rewords the body of a concept an agent wrote, in plain English, before a person confirms it, changing the wording and never a fact or a frontmatter byte, and its script proves that only the wording changed. -
ktl-sidecar skill checked by automation only, still a draft
Procedure that creates a .lokf/ sidecar, tooling, docs, a dummy skeleton, and the knowledge_bundle doorway link beside it, from bundled templates, or repairs a missing or broken sidecar file, then hands off to ktl-librarian. -
ktl-website skill checked by automation only, still a draft
Procedure that installs an Astro Starlight website for the knowledge bundle inwebsite/from bundled templates, with a page per concept and its trust label, a health page and the knowledge graph, and a workflow that publishes it to GitHub Pages onceKNOWLEDGE_WEBSITE_ENABLEDis set; or repairs and updates a site it installed, and hands the maintainer the steps that retire an mkdocs site it replaces. -
Open the knowledge bundle in Obsidian checked by automation only, still a draft
How a knowledge bundle meets an Obsidian vault: two vaults, the workshop someone keeps and the bundle opened as its own through theknowledge_bundledoorway, what Obsidian does with the link on each host, and why the bundle is never a real folder inside a vault. -
Releasing checked by automation only, still a draft
How a release happens:semantic-release.ymlcomputes the version from Conventional Commits and promotesCHANGELOG.mdon merge tomainbut never tags, and a maintainer’spublish.ymlrun checks that version against the changelog, letsgh skill publishcreate the tag and release, dispatchesknowledge-release.yamlto attach the bundle, domain schema and Copilot zips, and asks the sibling hosts to sync. -
Repository validation checked by automation only, still a draft
What CI checks on every pull request and weekly: the repository contract, the Agent Skills spec, shell and workflow linting, the install and website smoke tests, and Markdown, link and spelling checks. -
The docent in Microsoft 365 Copilot checked by automation only, still a draft
How a person gets ktl-docent-m365, the docent packed with a snapshot of the bundle as a Microsoft 365 Copilot custom skill, from a release or by building it, adds it to a declarative agent, checks the first answer and keeps it current, what to do when a step fails, and why only the read-only roles go there.