[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CAWNB9PMAPCF5K5ABBBGP6":3,"skill-same:01M7CAWNB9PMAPCF5K5ABBBGP6":237},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M7CAWNB9PMAPCF5K5ABBBGP6","ktl-sidecar",null,"Install a `.lokf\u002F` LOKF knowledge-bundle sidecar (tooling, docs, dummy skeleton, and a `knowledge_bundle` doorway link beside it) in the repository this skill sits in, from bundled templates. Use when: a repo has no `.lokf\u002F` yet and someone asks to add, scaffold, bootstrap, or set up a LOKF\u002Flokf sidecar, knowledge bundle, or machine-readable, SPARQL-queryable knowledge; or to repair a missing\u002Fbroken sidecar file. Not for authoring or maintaining concepts; that is the ktl-librarian skill, which this one hands off to when done. Keywords: OKF, Open Knowledge Format, LOKF, LinkML, knowledge graph, linked data, RDF, JSON-LD, WikiSkill, trust ladder.","noelmcloughlin\u002Fknowledge-trust-ladder","noelmcloughlin","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F13322818?v=4","01M7CATHZX114D86MFCWX0AT7R","N","01M7CATJ0MT4QGVPTBB4692GNQ",3,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ktl-sidecar\ndescription: 'Install a `.lokf\u002F` LOKF knowledge-bundle sidecar (tooling, docs, dummy skeleton, and a `knowledge_bundle` doorway link beside it) in the repository this skill sits in, from bundled templates. Use when: a repo has no `.lokf\u002F` yet and someone asks to add, scaffold, bootstrap, or set up a LOKF\u002Flokf sidecar, knowledge bundle, or machine-readable, SPARQL-queryable knowledge; or to repair a missing\u002Fbroken sidecar file. Not for authoring or maintaining concepts; that is the ktl-librarian skill, which this one hands off to when done. Keywords: OKF, Open Knowledge Format, LOKF, LinkML, knowledge graph, linked data, RDF, JSON-LD, WikiSkill, trust ladder.'\nlicense: Apache-2.0\ncompatibility: 'Requires a POSIX shell (bash; Git for Windows on Windows) and python3 or uv for placeholder substitution; uv with the lokf toolkit to validate (a manual cross-check otherwise). Any host (git or none, GitHub or another forge, Linux, macOS or Windows, a synced folder), with references\u002Fportability.md saying what each loses. Step 5''s workflows are GitHub Actions.'\n---\n\n# ktl-sidecar\n\nCreate a fresh **`.lokf\u002F` sidecar** inside the repository this skill is invoked from: a machine-readable, SPARQL-queryable [LOKF](https:\u002F\u002Flokf.nolan-nichols.com\u002F) knowledge bundle, with its directory, tooling, docs, and a small **dummy** skeleton. Then hand off to **ktl-librarian** to fill it with real knowledge. Every file is copied from `templates\u002F` (paths below are relative to this skill's directory), never retyped.\n\n> Sources: lokf.nolan-nichols.com is the canonical site for what LOKF *means*\n> (spec, Golden Rules). The tooling this skill installs comes from the\n> [`lokf` PyPI package](https:\u002F\u002Fpypi.org\u002Fproject\u002Flokf\u002F). With no Python, the\n> fallback (Step 4) is the raw schema from the commit tagged `v0.9.0`, which\n> matches `templates\u002Fpyproject.toml`'s floor:\n> \u003Chttps:\u002F\u002Fraw.githubusercontent.com\u002Fnicholsn\u002Flokf\u002Feab5fe35b99e154bec9aabc03656446b891311f8\u002Flokf.yaml>.\n> The URL never names a tag or `main`: a tag can be moved, and `main` can be\n> ahead of the toolkit. Cite each for its own role in generated docs.\n\n> Model: a small\u002Fmid-tier model is enough here: Step 1 copies templates and\n> substitutes placeholders; Step 0 is structured file lookup. Mistakes are\n> caught by Step 3's grep and Step 6's human sign-off. **ktl-librarian** is\n> the opposite case: keep it on the calling agent's normal model.\n\n## Scope\n\n- **This skill** runs **once**, to create `.lokf\u002F` or to **repair** a missing or broken sidecar file (anything in the Step 1\u002F5 tables). It never authors real concepts.\n- **ktl-librarian** runs **often**, to scrape the repo and create, maintain, and audit the actual concepts and typed relations.\n\n> Guardrails: if `.lokf\u002F` exists and is healthy, use ktl-librarian instead.\n> When repairing, (re)write only the missing\u002Fbroken file, including a missing\n> `llms.txt`\u002FREADME pointer on an older bundle. **Never overwrite concept\n> files.** Non-git, non-GitHub, or non-POSIX host: see\n> [references\u002Fportability.md](references\u002Fportability.md).\n\n## Step 0: gather the host project's facts\n\n**First, the preflight.** From the host repository's root, run `bash \u003Cskill>\u002Ftemplates\u002Fscripts\u002Fknowledge-preflight.sh`, where `\u003Cskill>` is this skill's directory, and read its screen before anything else. The copy under `.lokf\u002Fscripts\u002F` does not exist yet. Run from the skill's directory, it screens the skill and says so. It shows the host and shell, whether the tree is under git and on which forge, whether `uv` is present, which skill copies are installed and whether they differ, and whether the session is attended. Its last line names what is missing and which steps that disables; repeat that line in the Step 6 hand-off. A host whose shell is PowerShell, or that is not Linux, git or GitHub, has its own section in [references\u002Fportability.md](references\u002Fportability.md), and the preflight tells you which one applies.\n\nWhen the person you are working with cannot act on a `missing` or `warn` line themselves, write them a request note for the maintainer from [references\u002Fprerequisites.md](references\u002Fprerequisites.md). That page gives the plain meaning of each line, who fixes it, and what to send. Then carry on with what remains.\n\nResolve every placeholder from real project sources before writing anything; never leave a `\u003C...>` token or dummy value behind.\n\n| Placeholder | Meaning | Where to find it |\n| --- | --- | --- |\n| `\u003CPROJ_NAME>` | Human-readable project name | manifest `name` (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, ...), root `README.md` title, service catalog, or repo name |\n| `\u003CPROJ_DESC>` | One-sentence description | manifest `description`, README intro, or service catalog |\n| `\u003CPROJ_SLUG>` | lowercase-hyphenated slug | derive from `\u003CPROJ_NAME>` (`Acme Platform` -> `acme-platform`) |\n| `\u003CBASE_IRI>` | Bundle base IRI, **must end with `\u002F`** | (1) a persistent-identifier namespace the project already publishes under (w3id.org, purl.org, owned domain) + `\u002Fknowledge\u002F`; (2) a stable URL the project controls (docs `site_url`, Pages, service catalog) + `\u002Fknowledge\u002F`; (3) else `https:\u002F\u002F\u003CPROJ_SLUG>.example\u002Fknowledge\u002F`, flagged for review. **Never** the code-host repo URL (`https:\u002F\u002Fgithub.com\u002F\u003Corg>\u002F\u003Crepo>\u002F...`): that path space is not the project's, so the IDs could never resolve |\n| `\u003COWNER_NAME>` | Owning team\u002Forg display name | `CODEOWNERS`, manifest authors, service catalog, or README |\n| `\u003COWNER_SLUG>` | lowercase-hyphenated owner slug | derive from `\u003COWNER_NAME>` |\n| `\u003CTODAY>` | `YYYY-MM-DD` | system clock (for `log.md`) |\n\n`\u003CBASE_IRI>` matters most: each concept's `@id` is `base_iri` plus the concept's path. It need not resolve today, but must be stable and in a namespace the project controls (ktl-librarian Rule 2 has the authority test and migration steps). For a plain directory tree with no manifest, CODEOWNERS or repo, use the directory name, any document in the tree, and the `.example` fallback, and flag every guess in Step 6.\n\n**Tracked or gitignored: decide now.** Check whether the root `.gitignore` already excludes `.lokf\u002F` (ask if unclear). Committing `.lokf\u002F` is the default the four skills assume. Gitignoring it is equally valid (a personal bundle, or a policy against committing agent-authored content) but changes four things:\n\n- still create every file (the bundle is filesystem-based either way);\n- skip the commit in Step 4, and Step 5 apart from the scripts and the `m365\u002F` folder its table says to install anyway;\n- add the Step 2 `knowledge_bundle` symlink to the root `.gitignore` instead of committing it;\n- say so in the Step 6 handoff.\n\nThis is unrelated to `.lokf\u002F.gitignore` below, which only excludes tool build noise.\n\n**One layout, every host.** `.lokf\u002Fknowledge\u002F` is the real folder wherever the sidecar is installed (a code repository, a notes vault, a shared folder), and it is the name every skill, the toolkit, CI and `llms.txt` address. Step 2 adds `knowledge_bundle` beside it: a link, so people and folder pickers have an ordinary name to open. Never place the bundle as a *real* folder inside an Obsidian vault: the vault indexes it like any other folder, and the exhibition's notes show up in the workshop's link suggestions, graph and search. A shared folder that is not a vault is covered in [references\u002Fportability.md](references\u002Fportability.md).\n\n> Repo hygiene note: if the host repo installs AI skills locally, `.agents\u002F`, `.claude\u002F` and `skills-lock.json` are runtime state, not source. List them in the root `.gitignore`, or in `.git\u002Finfo\u002Fexclude` in a fork whose upstream owns that file, rather than commit them.\n\n## Step 1: create the skeleton and copy the templates\n\nCopy each template to its destination, then substitute the placeholders it lists. Only these placeholders exist; `templates\u002Fgitignore` and `templates\u002Fgitattributes` are written as `.lokf\u002F.gitignore` and `.lokf\u002F.gitattributes`.\n\n| Template | Destination | Placeholders |\n| --- | --- | --- |\n| `templates\u002Fpyproject.toml` | `.lokf\u002Fpyproject.toml` | PROJ_NAME, PROJ_SLUG |\n| `templates\u002Fgitignore` | `.lokf\u002F.gitignore` | - |\n| `templates\u002Fgitattributes` | `.lokf\u002F.gitattributes` (keeps the bundle on LF on every machine; inert without git) | - |\n| `templates\u002Fjustfile` | `.lokf\u002Fjustfile` | PROJ_NAME |\n| `templates\u002FREADME.md` | `.lokf\u002FREADME.md` | PROJ_NAME |\n| `templates\u002Fknowledge\u002Findex.md` | `.lokf\u002Fknowledge\u002Findex.md` (semantic header + TOC, reserved) | PROJ_NAME, PROJ_DESC, BASE_IRI, OWNER_NAME, OWNER_SLUG |\n| `templates\u002Fknowledge\u002Flog.md` | `.lokf\u002Fknowledge\u002Flog.md` (reserved) | PROJ_NAME, TODAY |\n| `templates\u002Fknowledge\u002Fservices\u002Findex.md` | `.lokf\u002Fknowledge\u002Fservices\u002Findex.md` | - |\n| `templates\u002Fknowledge\u002Fservices\u002Fexample-service-a.md`, `-b.md` | same paths under `.lokf\u002F` (DUMMY; ktl-librarian replaces) | PROJ_NAME, PROJ_SLUG, BASE_IRI |\n| `templates\u002Fqueries.http` *(optional, default on)* | `.lokf\u002Fqueries.http` | PROJ_NAME |\n| `templates\u002Fingest.yaml` | `.lokf\u002Fingest.yaml.sample`: the ingest's example manifest, unused until Step 5 copies it to `.lokf\u002Fingest.yaml` | - |\n\n```bash\nmkdir -p .lokf\u002Fknowledge\u002Fservices\n# ...copy the rows above, then substitute placeholders as literal text via\n# Python, not sed: sed's replacement is a fragment of its own s\u002F\u002F\u002F script, so\n# a value containing sed's delimiter or GNU sed's `e` (execute) command\n# changes what the command does, not just what text gets inserted - Python's\n# str.replace() has no such mini-language, so no value can do that.\nexport PROJ_NAME PROJ_DESC PROJ_SLUG BASE_IRI OWNER_NAME OWNER_SLUG TODAY\ngrep -rl -e '\u003CPROJ_' -e '\u003CBASE_IRI>' -e '\u003COWNER_' -e '\u003CTODAY>' .lokf \\\n  | xargs -I{} python3 -c '\nimport os, sys\npath = sys.argv[1]\ntext = open(path, encoding=\"utf-8\").read()\nfor token in (\"PROJ_NAME\", \"PROJ_DESC\", \"PROJ_SLUG\", \"BASE_IRI\", \"OWNER_NAME\", \"OWNER_SLUG\", \"TODAY\"):\n    text = text.replace(\"\u003C\" + token + \">\", os.environ[token])\nopen(path, \"w\", encoding=\"utf-8\").write(text)\n' {}\n```\n\n## Step 2: point agents and humans at the bundle (optional, root-level)\n\nMake three additions at the **repo root**, outside `.lokf\u002F`. Add only, never overwrite, and check for an existing item first. All three stay true **whether or not `.lokf\u002F` exists later**, so nothing ever needs cleaning up if the bundle is removed. Keep that self-qualifying phrasing (a dangling symlink is harmless and easy to spot).\n\n- **`llms.txt`**: copy `templates\u002Fllms.txt` (PROJ_NAME, PROJ_DESC) if absent. If it exists, leave it intact and append only the `## Agent context` section, and only if the file does not already mention `.lokf\u002F`.\n- **README pointer**: if `README.md` exists and does not already link to `.lokf\u002Fknowledge\u002F` anywhere (check the path, not a heading string), insert `templates\u002Freadme-for-ai-agents.md` after the intro, before the first `##`. It is a one-paragraph blockquote aside, not a section, and it addresses both readers a README has. A person learns there is a second way in (install `ktl-docent` and ask). An agent, which reads the top of a README, is told to read the bundle first. The trust-weighing detail lives in `llms.txt` rather than being repeated here. If one question this host's readers keep asking comes to mind, put it in the aside as the example; a concrete question is what makes a person try it. Do not invent a README on a host that has none.\n- **`knowledge_bundle` symlink**: the bundle under an ordinary, visible name, beside the hidden `.lokf\u002F`. Finder and most folder pickers hide dot-directories, a repository listing shows nothing else, and a double-click in a file manager should open the bundle. So the doorway is the one name a person needs to know, whatever they open it with. If nothing named `knowledge_bundle` already exists at the repo root:\n\n  ```bash\n  ln -s .lokf\u002Fknowledge knowledge_bundle\n  ```\n\n    Run it from the repo root. The target is relative, which keeps the link valid after a clone or move (`just lokf-link` from `.lokf\u002F` does the same, and recreates it on a machine where a sync service dropped it). Mirror the Step 0 tracked\u002Fgitignored decision: commit it alongside a tracked `.lokf\u002F`, or add `knowledge_bundle` to the root `.gitignore` alongside a gitignored one. This is POSIX only. On Windows a junction does the job with no elevated rights (`mklink \u002FJ knowledge_bundle .lokf\\knowledge`). On a filesystem without links, skip it (see [references\u002Fportability.md](references\u002Fportability.md)); the bundle works identically without it. If the host repo lints, spell-checks, or link-checks `**\u002F*.md` repo-wide, exclude `knowledge_bundle\u002F` from that config. Otherwise the same files under `.lokf\u002Fknowledge\u002F` are processed twice, once at each path.\n\n    **If the person uses Obsidian** (optional; every step here is the same without it), they open `knowledge_bundle` *itself* as a vault (File → Open folder as vault). That is the exhibition, beside whatever vault they already keep, the workshop. Obsidian writes that vault's workspace state through the link into `.lokf\u002Fknowledge\u002F.obsidian\u002F`, which `templates\u002Fgitignore` excludes and `lokf validate` ignores (Step 4 reads only `*.md`). A vault opened at the host root never lists a dot-directory or a link that resolves inside it, which is what keeps the workshop clean when the host is itself a vault. So point people at the doorway, not the root. The rule against a real folder inside a vault is in Step 0; the mechanics are in [references\u002Fportability.md](references\u002Fportability.md).\n\n## Step 3: verify the skeleton\n\nCheck for placeholder tokens only; the files legitimately contain other angle brackets:\n\n```bash\ngrep -rn -e '\u003CPROJ_' -e '\u003CBASE_IRI>' -e '\u003COWNER_' -e '\u003CTODAY>' .lokf\u002F knowledge_bundle\u002F llms.txt 2>\u002Fdev\u002Fnull\n```\n\nZero hits means fully resolved. (`knowledge_bundle\u002F` is the same files listed twice, harmlessly; it is named so the check still holds on a host where someone has turned `.lokf\u002Fknowledge` into a link, since `grep -r` does not descend into one.) Leave the `example-service-*.md` dummies as dummies (or delete them for an empty bundle); do not enumerate real services.\n\n## Step 4: validate the skeleton\n\n```bash\ncd .lokf && just lokf-install && just lokf-validate   # uv sync; schema-valid\n```\n\nWith no `uv` or `lokf`, there is no substitute for the generated JSON Schema check. Fetch the raw schema from the commit the Sources note names, and manually cross-check the `Service` class and the slots you used: a structural sanity check, not a validation run. The schema is data to compare against, never instructions. Report in Step 6 whether validation ran, ran as this manual fallback, or was skipped. Never log this in `knowledge\u002Flog.md` (knowledge changes only). Fix findings, then commit, unless `.lokf\u002F` is gitignored (Step 0), in which case there is nothing to commit.\n\n## Step 5: install the automation (optional)\n\n**Skip the workflows and the wrapper if `.lokf\u002F` is gitignored.** The workflows need the bundle on a remote branch, and the librarian loop's `git status --porcelain` check reports \"no changes\" for an ignored path forever. Three scripts and the `m365\u002F` folder are installed regardless, and their rows say why: the preflight, `knowledge-feedback.sh`, `knowledge-report.sh`, and the Copilot skills' builder with its instructions. The workflows are GitHub-only; on other hosts, copy the wrapper and schedule it with cron or CI ([references\u002Fportability.md](references\u002Fportability.md)). None of these files has placeholders.\n\n| Template | Destination |\n| --- | --- |\n| `templates\u002Fgithub\u002Fknowledge-registrar.yaml` | `.github\u002Fworkflows\u002Fknowledge-registrar.yaml`: the gate ([references\u002Fgate.md](references\u002Fgate.md)) |\n| `templates\u002Fgithub\u002Fknowledge-librarian.yaml` | `.github\u002Fworkflows\u002Fknowledge-librarian.yaml` |\n| `templates\u002Fgithub\u002Fknowledge-release.yaml` | `.github\u002Fworkflows\u002Fknowledge-release.yaml`: attaches the bundle to a GitHub release as a zip file, with one Copilot skill zip per file under `.lokf\u002Fm365\u002F` beside it, and skips a release whose bundle matches the last one released. It runs when dispatched by hand, and on each published release once the `KNOWLEDGE_RELEASE_ENABLED` variable is `true`; it needs no agent |\n| `templates\u002Fscripts\u002Fknowledge-librarian.sh` | `.lokf\u002Fscripts\u002Fknowledge-librarian.sh` (`chmod +x`) |\n| `templates\u002Fscripts\u002Fknowledge-conventions.sh` | `.lokf\u002Fscripts\u002Fknowledge-conventions.sh` (`chmod +x`); the gate runs it, and so does ktl-librarian's audit |\n| `templates\u002Fscripts\u002Fknowledge-conventions.py` | `.lokf\u002Fscripts\u002Fknowledge-conventions.py` (`chmod +x`): the half of the conventions script that parses YAML. The `.sh` runs it through `uv run` and fails without it, so install the two together |\n| `templates\u002Fscripts\u002Fknowledge-preflight.sh` | `.lokf\u002Fscripts\u002Fknowledge-preflight.sh` (`chmod +x`): what this host can do; every skill runs it first (Step 0 here). Install it even when the rest of this step is skipped: it needs neither git nor GitHub |\n| `templates\u002Fscripts\u002Fknowledge-provenance.sh` | `.lokf\u002Fscripts\u002Fknowledge-provenance.sh` (`chmod +x`): the signature half of the gate on any host with git, and gpg or ssh-keygen. It verifies only once `.lokf\u002Fcurators\u002F\u003Cid>.asc` (GPG) or `\u003Cid>.pub` (SSH) keys exist ([references\u002Fportability.md](references\u002Fportability.md)) |\n| `templates\u002Fscripts\u002Fknowledge-feedback.sh` | `.lokf\u002Fscripts\u002Fknowledge-feedback.sh` (`chmod +x`): records a reader's Miss or Disagreement in `.lokf\u002Ffeedback.md` without opening it, so no other reader's report reaches the session. ktl-docent runs its own copy and never this one, which serves a person and an earlier ktl-docent. Install it even when the rest of this step is skipped: a gitignored bundle still takes feedback, and it needs neither git nor GitHub |\n| `templates\u002Fscripts\u002Fknowledge-apply.sh` | `.lokf\u002Fscripts\u002Fknowledge-apply.sh` (`chmod +x`): the pen, the librarian's only way to write the bundle. ktl-librarian describes each change as an operation in `.lokf\u002Fpatch.yaml`, and this script checks every operation and writes the bundle; the wrapper runs it after the scheduled agent finishes. |\n| `templates\u002Fscripts\u002Fknowledge-apply.py` | `.lokf\u002Fscripts\u002Fknowledge-apply.py` (`chmod +x`): the half of the apply script that parses YAML. The `.sh` runs it through `uv run`. |\n| `templates\u002Fscripts\u002Fknowledge-report.sh` | `.lokf\u002Fscripts\u002Fknowledge-report.sh` (`chmod +x`): what a program can say about the bundle, so that no model works it out. It prints each concept's trust label, the health line, ktl-librarian's work list, the curator's sample, the evidence table and what a change does to the record. It scores the index-only retrieval test and counts the tracked files no concept names. ktl-curator and ktl-librarian quote it, ktl-docent quotes its own copy, and the librarian workflow fills its pull request from it. Install it even when the rest of this step is skipped: it needs bash and awk, and git only where there is one |\n| `templates\u002Fm365\u002Fknowledge-m365.sh` | `.lokf\u002Fm365\u002Fknowledge-m365.sh` (`chmod +x`): builds one Microsoft 365 Copilot custom skill per instructions file beside it, each with a snapshot of the bundle inside. The release workflow runs it and attaches each zip beside the bundle zip; what Copilot allows and what each role can be there: [references\u002Fm365.md](references\u002Fm365.md). Install it even when the rest of this step is skipped: a host with no git builds the skill by hand and uploads it, and it needs neither git nor GitHub |\n| `templates\u002Fdomain.yaml`, `templates\u002Fscripts\u002Fknowledge-federate.py`, `templates\u002Fgithub\u002Fknowledge-federation.yaml` *(a domain host only)* | `.lokf\u002Fschema\u002Fdomain.yaml`, `.lokf\u002Fscripts\u002Fknowledge-federate.py` (`chmod +x`), `.github\u002Fworkflows\u002Fknowledge-federation.yaml`: a bundle whose concepts are other bundles, the workspace built from their releases or the files their sites serve, its readers (`mcp`, `serve`, `query`) and `diff` for release notes; [references\u002Fautomation.md](references\u002Fautomation.md) says how |\n| `templates\u002Fgithub\u002Fknowledge-sync.yaml`, `templates\u002Fscripts\u002Fknowledge-sync.sh`, `templates\u002Fgithub\u002Fknowledge-sync-pull-request.md` | `.github\u002Fworkflows\u002Fknowledge-sync.yaml`, `.lokf\u002Fscripts\u002Fknowledge-sync.sh` (`chmod +x`), `.github\u002FPULL_REQUEST_TEMPLATE\u002Fknowledge-sync.md`: keep the copies and the skills pin at the newest release of the skills repository, as `templates\u002Fknowledge-sync.manifest` lists them. The workflow checks each week and opens one pull request from the template when the pin is behind, refreshed until merged; the script does the same by hand with `--pr \u003Ctag>`. Install the three wherever the librarian workflow is; [references\u002Fautomation.md](references\u002Fautomation.md) says how to set its token up |\n| `templates\u002Fm365\u002Fktl-docent-m365.md` | `.lokf\u002Fm365\u002Fktl-docent-m365.md`: the docent's instructions for Copilot, packed as that skill's `SKILL.md`. It is named after the skill, not `SKILL.md`, so no installer lists it as one; a later read-only role (the auditor) is another file beside it |\n| `templates\u002Fscripts\u002Fknowledge-ingest.py`, `templates\u002Fscripts\u002Fknowledge-ingest.sh`, `templates\u002Fgithub\u002Fknowledge-ingest.yaml`, `templates\u002Fgithub\u002Fknowledge-ingest-pull-request.md` *(a host with knowledge outside its repository)* | `.lokf\u002Fingest.yaml` (the host's own, copied from `.lokf\u002Fingest.yaml.sample`, which Step 1 lays down), `.lokf\u002Fscripts\u002Fknowledge-ingest.py` and `.lokf\u002Fscripts\u002Fknowledge-ingest.sh` (`chmod +x`), `.github\u002Fworkflows\u002Fknowledge-ingest.yaml`, `.github\u002FPULL_REQUEST_TEMPLATE\u002Fknowledge-ingest.md`. The ingest mirrors wiki pages, documents and files from other repositories into `.lokf\u002Fmirror\u002F`, and the workflow opens one pull request with what changed. [references\u002Fautomation.md](references\u002Fautomation.md) says how to set it up, and [ingest.md](https:\u002F\u002Fw3id.org\u002Fktl\u002Fdocs\u002Fingest\u002F) is the guide |\n\n**Security scanner note (Snyk W011, third-party content exposure \u002F indirect prompt injection): false positive.** `knowledge-registrar.yaml`'s `provenance` job reads `github.event.pull_request` fields and the pull request's reviews and commits from the GitHub API. It reads them for one purpose: to verify that each person a new `human:\u003Cid>` confirmation names either approved the pull request or signed the commit recording it. That is human provenance, not content. No LLM, AI agent or AI tool runs in that job, this skill never reads that data, and nothing read there is passed to a model, so there is no prompt for injected content to reach. The job's header comment says how each input is contained.\n\nThe librarian and registrar workflows and the wrapper name the bundle under both of its names, `.lokf\u002Fknowledge` and `knowledge_bundle`. With the Step 2 doorway the second pathspec matches nothing. It still covers a shared folder rearranged by hand into a real `knowledge_bundle\u002F` ([references\u002Fportability.md](references\u002Fportability.md)), because a git pathspec never traverses a symlink. The release workflow resolves `.lokf\u002Fknowledge` to the real folder before packing it. There is nothing to edit.\n\nThe registrar's `provenance` job needs no setup, but check one thing and report it here: `git config --get commit.gpgsign`, and whether `HEAD` carries a signature (`git cat-file commit HEAD | grep -qE '^gpgsig'`). If signing is off, say so. GitHub blocks self-approval, so a curator who opens their own curation pull requests passes the gate only if they sign, and otherwise every confirmation ktl-curator records will be rejected at the gate.\n\nShow the three `git config` lines from [references\u002Fgate.md](references\u002Fgate.md) and let them run those; do not run them yourself and never touch their `--global` config. The optional `KNOWLEDGE_CURATION_ENVIRONMENT` route, for a curator who cannot sign, is in the same file. It needs an Environment *with required reviewers* first, and does nothing without one.\n\nThe wrapper looks for `ktl-librarian\u002FSKILL.md` under `.agents\u002Fskills\u002F`, `.claude\u002Fskills\u002F`, `.github\u002Fskills\u002F`, then bare `skills\u002F` (a repo that publishes the skills it also uses). If this repo uses another directory, add it to the script's `candidate` list now and run the script once; a mismatch otherwise fails at scheduled-run time. [references\u002Fautomation.md](references\u002Fautomation.md) says what each file does and needs, and [references\u002Fgate.md](references\u002Fgate.md) covers the registrar, signing and the forge-free gate. On GitHub, run `uvx ktl gh plan` and show the person what it lists; `ktl gh apply` sets it once they agree ([references\u002Frepository-settings.md](references\u002Frepository-settings.md)).\n\nNothing in the host lints these files yet. Check whether the host already runs ShellCheck and `actionlint` over its tree. If it does not, say so and suggest, in one line, coverage for the nine `scripts\u002F*.sh`, `m365\u002F*.sh`, the `scripts\u002F*.py` and the six `.github\u002Fworkflows\u002F*.yaml`, so a scheduled agent's wrapper is not left unchecked. A full lint and release CI is the host's choice; `lint-and-docs.yaml` in this skill's home repository is one shape, never copied wholesale.\n\n## Step 6: hand off to ktl-librarian\n\nThe sidecar ends here. ktl-librarian's first run is a **bootstrap discovery** pass that records the repo's knowledge sources as `playbooks\u002Fknowledge-sources.md`. The librarian in turn hands off to **ktl-curator**, where a person confirms what it derived, and **ktl-docent** answers readers from the bundle, recording what it lacked for the librarian's next run. So all four skills should be installed, and **ktl-website** can publish the bundle as a site once it is worth showing. In the handoff, tell the user:\n\n- which Step 0 values were **guessed** rather than found (a fallback `\u003CBASE_IRI>` above all; every `@id` starts with it, so it needs sign-off);\n- whether Step 4 validation ran, ran as the manual fallback, or was skipped;\n- which optional pieces (`queries.http`, Step 2 pointers, Step 5 automation) were added, appended to, or left alone because they already existed;\n- whether `.lokf\u002F` is **git-tracked or gitignored**; this decides whether ktl-librarian's pull-request review and any Step 5 automation apply;\n- whether the **`knowledge_bundle` doorway** was created and, if not (Windows, no symlink support, a name already taken), the one command that makes it: `ln -s .lokf\u002Fknowledge knowledge_bundle`, `just lokf-link` from `.lokf\u002F`, or `mklink \u002FJ knowledge_bundle .lokf\\knowledge`. On a synced host, say that sync services carry `.lokf\u002F` but drop links, so the doorway is per machine. On an Obsidian vault host, say that the bundle is opened by picking `knowledge_bundle` *itself* as a vault, and the vault they already have never lists it.\n","# ktl-sidecar\n\nCreate a fresh **`.lokf\u002F` sidecar** inside the repository this skill is invoked from: a machine-readable, SPARQL-queryable [LOKF](https:\u002F\u002Flokf.nolan-nichols.com\u002F) knowledge bundle, with its directory, tooling, docs, and a small **dummy** skeleton. Then hand off to **ktl-librarian** to fill it with real knowledge. Every file is copied from `templates\u002F` (paths below are relative to this skill's directory), never retyped.\n\n> Sources: lokf.nolan-nichols.com is the canonical site for what LOKF *means*\n> (spec, Golden Rules). The tooling this skill installs comes from the\n> [`lokf` PyPI package](https:\u002F\u002Fpypi.org\u002Fproject\u002Flokf\u002F). With no Python, the\n> fallback (Step 4) is the raw schema from the commit tagged `v0.9.0`, which\n> matches `templates\u002Fpyproject.toml`'s floor:\n> \u003Chttps:\u002F\u002Fraw.githubusercontent.com\u002Fnicholsn\u002Flokf\u002Feab5fe35b99e154bec9aabc03656446b891311f8\u002Flokf.yaml>.\n> The URL never names a tag or `main`: a tag can be moved, and `main` can be\n> ahead of the toolkit. Cite each for its own role in generated docs.\n\n> Model: a small\u002Fmid-tier model is enough here: Step 1 copies templates and\n> substitutes placeholders; Step 0 is structured file lookup. Mistakes are\n> caught by Step 3's grep and Step 6's human sign-off. **ktl-librarian** is\n> the opposite case: keep it on the calling agent's normal model.\n\n## Scope\n\n- **This skill** runs **once**, to create `.lokf\u002F` or to **repair** a missing or broken sidecar file (anything in the Step 1\u002F5 tables). It never authors real concepts.\n- **ktl-librarian** runs **often**, to scrape the repo and create, maintain, and audit the actual concepts and typed relations.\n\n> Guardrails: if `.lokf\u002F` exists and is healthy, use ktl-librarian instead.\n> When repairing, (re)write only the missing\u002Fbroken file, including a missing\n> `llms.txt`\u002FREADME pointer on an older bundle. **Never overwrite concept\n> files.** Non-git, non-GitHub, or non-POSIX host: see\n> [references\u002Fportability.md](references\u002Fportability.md).\n\n## Step 0: gather the host project's facts\n\n**First, the preflight.** From the host repository's root, run `bash \u003Cskill>\u002Ftemplates\u002Fscripts\u002Fknowledge-preflight.sh`, where `\u003Cskill>` is this skill's directory, and read its screen before anything else. The copy under `.lokf\u002Fscripts\u002F` does not exist yet. Run from the skill's directory, it screens the skill and says so. It shows the host and shell, whether the tree is under git and on which forge, whether `uv` is present, which skill copies are installed and whether they differ, and whether the session is attended. Its last line names what is missing and which steps that disables; repeat that line in the Step 6 hand-off. A host whose shell is PowerShell, or that is not Linux, git or GitHub, has its own section in [references\u002Fportability.md](references\u002Fportability.md), and the preflight tells you which one applies.\n\nWhen the person you are working with cannot act on a `missing` or `warn` line themselves, write them a request note for the maintainer from [references\u002Fprerequisites.md](references\u002Fprerequisites.md). That page gives the plain meaning of each line, who fixes it, and what to send. Then carry on with what remains.\n\nResolve every placeholder from real project sources before writing anything; never leave a `\u003C...>` token or dummy value behind.\n\n| Placeholder | Meaning | Where to find it |\n| --- | --- | --- |\n| `\u003CPROJ_NAME>` | Human-readable project name | manifest `name` (`package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, ...), root `README.md` title, service catalog, or repo name |\n| `\u003CPROJ_DESC>` | One-sentence description | manifest `description`, README intro, or service catalog |\n| `\u003CPROJ_SLUG>` | lowercase-hyphenated slug | derive from `\u003CPROJ_NAME>` (`Acme Platform` -> `acme-platform`) |\n| `\u003CBASE_IRI>` | Bundle base IRI, **must end with `\u002F`** | (1) a persistent-identifier namespace the project already publishes under (w3id.org, purl.org, owned domain) + `\u002Fknowledge\u002F`; (2) a stable URL the project controls (docs `site_url`, Pages, service catalog) + `\u002Fknowledge\u002F`; (3) else `https:\u002F\u002F\u003CPROJ_SLUG>.example\u002Fknowledge\u002F`, flagged for review. **Never** the code-host repo URL (`https:\u002F\u002Fgithub.com\u002F\u003Corg>\u002F\u003Crepo>\u002F...`): that path space is not the project's, so the IDs could never resolve |\n| `\u003COWNER_NAME>` | Owning team\u002Forg display name | `CODEOWNERS`, manifest authors, service catalog, or README |\n| `\u003COWNER_SLUG>` | lowercase-hyphenated owner slug | derive from `\u003COWNER_NAME>` |\n| `\u003CTODAY>` | `YYYY-MM-DD` | system clock (for `log.md`) |\n\n`\u003CBASE_IRI>` matters most: each concept's `@id` is `base_iri` plus the concept's path. It need not resolve today, but must be stable and in a namespace the project controls (ktl-librarian Rule 2 has the authority test and migration steps). For a plain directory tree with no manifest, CODEOWNERS or repo, use the directory name, any document in the tree, and the `.example` fallback, and flag every guess in Step 6.\n\n**Tracked or gitignored: decide now.** Check whether the root `.gitignore` already excludes `.lokf\u002F` (ask if unclear). Committing `.lokf\u002F` is the default the four skills assume. Gitignoring it is equally valid (a personal bundle, or a policy against committing agent-authored content) but changes four things:\n\n- still create every file (the bundle is filesystem-based either way);\n- skip the commit in Step 4, and Step 5 apart from the scripts and the `m365\u002F` folder its table says to install anyway;\n- add the Step 2 `knowledge_bundle` symlink to the root `.gitignore` instead of committing it;\n- say so in the Step 6 handoff.\n\nThis is unrelated to `.lokf\u002F.gitignore` below, which only excludes tool build noise.\n\n**One layout, every host.** `.lokf\u002Fknowledge\u002F` is the real folder wherever the sidecar is installed (a code repository, a notes vault, a shared folder), and it is the name every skill, the toolkit, CI and `llms.txt` address. Step 2 adds `knowledge_bundle` beside it: a link, so people and folder pickers have an ordinary name to open. Never place the bundle as a *real* folder inside an Obsidian vault: the vault indexes it like any other folder, and the exhibition's notes show up in the workshop's link suggestions, graph and search. A shared folder that is not a vault is covered in [references\u002Fportability.md](references\u002Fportability.md).\n\n> Repo hygiene note: if the host repo installs AI skills locally, `.agents\u002F`, `.claude\u002F` and `skills-lock.json` are runtime state, not source. List them in the root `.gitignore`, or in `.git\u002Finfo\u002Fexclude` in a fork whose upstream owns that file, rather than commit them.\n\n## Step 1: create the skeleton and copy the templates\n\nCopy each template to its destination, then substitute the placeholders it lists. Only these placeholders exist; `templates\u002Fgitignore` and `templates\u002Fgitattributes` are written as `.lokf\u002F.gitignore` and `.lokf\u002F.gitattributes`.\n\n| Template | Destination | Placeholders |\n| --- | --- | --- |\n| `templates\u002Fpyproject.toml` | `.lokf\u002Fpyproject.toml` | PROJ_NAME, PROJ_SLUG |\n| `templates\u002Fgitignore` | `.lokf\u002F.gitignore` | - |\n| `templates\u002Fgitattributes` | `.lokf\u002F.gitattributes` (keeps the bundle on LF on every machine; inert without git) | - |\n| `templates\u002Fjustfile` | `.lokf\u002Fjustfile` | PROJ_NAME |\n| `templates\u002FREADME.md` | `.lokf\u002FREADME.md` | PROJ_NAME |\n| `templates\u002Fknowledge\u002Findex.md` | `.lokf\u002Fknowledge\u002Findex.md` (semantic header + TOC, reserved) | PROJ_NAME, PROJ_DESC, BASE_IRI, OWNER_NAME, OWNER_SLUG |\n| `templates\u002Fknowledge\u002Flog.md` | `.lokf\u002Fknowledge\u002Flog.md` (reserved) | PROJ_NAME, TODAY |\n| `templates\u002Fknowledge\u002Fservices\u002Findex.md` | `.lokf\u002Fknowledge\u002Fservices\u002Findex.md` | - |\n| `templates\u002Fknowledge\u002Fservices\u002Fexample-service-a.md`, `-b.md` | same paths under `.lokf\u002F` (DUMMY; ktl-librarian replaces) | PROJ_NAME, PROJ_SLUG, BASE_IRI |\n| `templates\u002Fqueries.http` *(optional, default on)* | `.lokf\u002Fqueries.http` | PROJ_NAME |\n| `templates\u002Fingest.yaml` | `.lokf\u002Fingest.yaml.sample`: the ingest's example manifest, unused until Step 5 copies it to `.lokf\u002Fingest.yaml` | - |\n\n```bash\nmkdir -p .lokf\u002Fknowledge\u002Fservices\n# ...copy the rows above, then substitute placeholders as literal text via\n# Python, not sed: sed's replacement is a fragment of its own s\u002F\u002F\u002F script, so\n# a value containing sed's delimiter or GNU sed's `e` (execute) command\n# changes what the command does, not just what text gets inserted - Python's\n# str.replace() has no such mini-language, so no value can do that.\nexport PROJ_NAME PROJ_DESC PROJ_SLUG BASE_IRI OWNER_NAME OWNER_SLUG TODAY\ngrep -rl -e '\u003CPROJ_' -e '\u003CBASE_IRI>' -e '\u003COWNER_' -e '\u003CTODAY>' .lokf \\\n  | xargs -I{} python3 -c '\nimport os, sys\npath = sys.argv[1]\ntext = open(path, encoding=\"utf-8\").read()\nfor token in (\"PROJ_NAME\", \"PROJ_DESC\", \"PROJ_SLUG\", \"BASE_IRI\", \"OWNER_NAME\", \"OWNER_SLUG\", \"TODAY\"):\n    text = text.replace(\"\u003C\" + token + \">\", os.environ[token])\nopen(path, \"w\", encoding=\"utf-8\").write(text)\n' {}\n```\n\n## Step 2: point agents and humans at the bundle (optional, root-level)\n\nMake three additions at the **repo root**, outside `.lokf\u002F`. Add only, never overwrite, and check for an existing item first. All three stay true **whether or not `.lokf\u002F` exists later**, so nothing ever needs cleaning up if the bundle is removed. Keep that self-qualifying phrasing (a dangling symlink is harmless and easy to spot).\n\n- **`llms.txt`**: copy `templates\u002Fllms.txt` (PROJ_NAME, PROJ_DESC) if absent. If it exists, leave it intact and append only the `## Agent context` section, and only if the file does not already mention `.lokf\u002F`.\n- **README pointer**: if `README.md` exists and does not already link to `.lokf\u002Fknowledge\u002F` anywhere (check the path, not a heading string), insert `templates\u002Freadme-for-ai-agents.md` after the intro, before the first `##`. It is a one-paragraph blockquote aside, not a section, and it addresses both readers a README has. A person learns there is a second way in (install `ktl-docent` and ask). An agent, which reads the top of a README, is told to read the bundle first. The trust-weighing detail lives in `llms.txt` rather than being repeated here. If one question this host's readers keep asking comes to mind, put it in the aside as the example; a concrete question is what makes a person try it. Do not invent a README on a host that has none.\n- **`knowledge_bundle` symlink**: the bundle under an ordinary, visible name, beside the hidden `.lokf\u002F`. Finder and most folder pickers hide dot-directories, a repository listing shows nothing else, and a double-click in a file manager should open the bundle. So the doorway is the one name a person needs to know, whatever they open it with. If nothing named `knowledge_bundle` already exists at the repo root:\n\n  ```bash\n  ln -s .lokf\u002Fknowledge knowledge_bundle\n  ```\n\n    Run it from the repo root. The target is relative, which keeps the link valid after a clone or move (`just lokf-link` from `.lokf\u002F` does the same, and recreates it on a machine where a sync service dropped it). Mirror the Step 0 tracked\u002Fgitignored decision: commit it alongside a tracked `.lokf\u002F`, or add `knowledge_bundle` to the root `.gitignore` alongside a gitignored one. This is POSIX only. On Windows a junction does the job with no elevated rights (`mklink \u002FJ knowledge_bundle .lokf\\knowledge`). On a filesystem without links, skip it (see [references\u002Fportability.md](references\u002Fportability.md)); the bundle works identically without it. If the host repo lints, spell-checks, or link-checks `**\u002F*.md` repo-wide, exclude `knowledge_bundle\u002F` from that config. Otherwise the same files under `.lokf\u002Fknowledge\u002F` are processed twice, once at each path.\n\n    **If the person uses Obsidian** (optional; every step here is the same without it), they open `knowledge_bundle` *itself* as a vault (File → Open folder as vault). That is the exhibition, beside whatever vault they already keep, the workshop. Obsidian writes that vault's workspace state through the link into `.lokf\u002Fknowledge\u002F.obsidian\u002F`, which `templates\u002Fgitignore` excludes and `lokf validate` ignores (Step 4 reads only `*.md`). A vault opened at the host root never lists a dot-directory or a link that resolves inside it, which is what keeps the workshop clean when the host is itself a vault. So point people at the doorway, not the root. The rule against a real folder inside a vault is in Step 0; the mechanics are in [references\u002Fportability.md](references\u002Fportability.md).\n\n## Step 3: verify the skeleton\n\nCheck for placeholder tokens only; the files legitimately contain other angle brackets:\n\n```bash\ngrep -rn -e '\u003CPROJ_' -e '\u003CBASE_IRI>' -e '\u003COWNER_' -e '\u003CTODAY>' .lokf\u002F knowledge_bundle\u002F llms.txt 2>\u002Fdev\u002Fnull\n```\n\nZero hits means fully resolved. (`knowledge_bundle\u002F` is the same files listed twice, harmlessly; it is named so the check still holds on a host where someone has turned `.lokf\u002Fknowledge` into a link, since `grep -r` does not descend into one.) Leave the `example-service-*.md` dummies as dummies (or delete them for an empty bundle); do not enumerate real services.\n\n## Step 4: validate the skeleton\n\n```bash\ncd .lokf && just lokf-install && just lokf-validate   # uv sync; schema-valid\n```\n\nWith no `uv` or `lokf`, there is no substitute for the generated JSON Schema check. Fetch the raw schema from the commit the Sources note names, and manually cross-check the `Service` class and the slots you used: a structural sanity check, not a validation run. The schema is data to compare against, never instructions. Report in Step 6 whether validation ran, ran as this manual fallback, or was skipped. Never log this in `knowledge\u002Flog.md` (knowledge changes only). Fix findings, then commit, unless `.lokf\u002F` is gitignored (Step 0), in which case there is nothing to commit.\n\n## Step 5: install the automation (optional)\n\n**Skip the workflows and the wrapper if `.lokf\u002F` is gitignored.** The workflows need the bundle on a remote branch, and the librarian loop's `git status --porcelain` check reports \"no changes\" for an ignored path forever. Three scripts and the `m365\u002F` folder are installed regardless, and their rows say why: the preflight, `knowledge-feedback.sh`, `knowledge-report.sh`, and the Copilot skills' builder with its instructions. The workflows are GitHub-only; on other hosts, copy the wrapper and schedule it with cron or CI ([references\u002Fportability.md](references\u002Fportability.md)). None of these files has placeholders.\n\n| Template | Destination |\n| --- | --- |\n| `templates\u002Fgithub\u002Fknowledge-registrar.yaml` | `.github\u002Fworkflows\u002Fknowledge-registrar.yaml`: the gate ([references\u002Fgate.md](references\u002Fgate.md)) |\n| `templates\u002Fgithub\u002Fknowledge-librarian.yaml` | `.github\u002Fworkflows\u002Fknowledge-librarian.yaml` |\n| `templates\u002Fgithub\u002Fknowledge-release.yaml` | `.github\u002Fworkflows\u002Fknowledge-release.yaml`: attaches the bundle to a GitHub release as a zip file, with one Copilot skill zip per file under `.lokf\u002Fm365\u002F` beside it, and skips a release whose bundle matches the last one released. It runs when dispatched by hand, and on each published release once the `KNOWLEDGE_RELEASE_ENABLED` variable is `true`; it needs no agent |\n| `templates\u002Fscripts\u002Fknowledge-librarian.sh` | `.lokf\u002Fscripts\u002Fknowledge-librarian.sh` (`chmod +x`) |\n| `templates\u002Fscripts\u002Fknowledge-conventions.sh` | `.lokf\u002Fscripts\u002Fknowledge-conventions.sh` (`chmod +x`); the gate runs it, and so does ktl-librarian's audit |\n| `templates\u002Fscripts\u002Fknowledge-conventions.py` | `.lokf\u002Fscripts\u002Fknowledge-conventions.py` (`chmod +x`): the half of the conventions script that parses YAML. The `.sh` runs it through `uv run` and fails without it, so install the two together |\n| `templates\u002Fscripts\u002Fknowledge-preflight.sh` | `.lokf\u002Fscripts\u002Fknowledge-preflight.sh` (`chmod +x`): what this host can do; every skill runs it first (Step 0 here). Install it even when the rest of this step is skipped: it needs neither git nor GitHub |\n| `templates\u002Fscripts\u002Fknowledge-provenance.sh` | `.lokf\u002Fscripts\u002Fknowledge-provenance.sh` (`chmod +x`): the signature half of the gate on any host with git, and gpg or ssh-keygen. It verifies only once `.lokf\u002Fcurators\u002F\u003Cid>.asc` (GPG) or `\u003Cid>.pub` (SSH) keys exist ([references\u002Fportability.md](references\u002Fportability.md)) |\n| `templates\u002Fscripts\u002Fknowledge-feedback.sh` | `.lokf\u002Fscripts\u002Fknowledge-feedback.sh` (`chmod +x`): records a reader's Miss or Disagreement in `.lokf\u002Ffeedback.md` without opening it, so no other reader's report reaches the session. ktl-docent runs its own copy and never this one, which serves a person and an earlier ktl-docent. Install it even when the rest of this step is skipped: a gitignored bundle still takes feedback, and it needs neither git nor GitHub |\n| `templates\u002Fscripts\u002Fknowledge-apply.sh` | `.lokf\u002Fscripts\u002Fknowledge-apply.sh` (`chmod +x`): the pen, the librarian's only way to write the bundle. ktl-librarian describes each change as an operation in `.lokf\u002Fpatch.yaml`, and this script checks every operation and writes the bundle; the wrapper runs it after the scheduled agent finishes. |\n| `templates\u002Fscripts\u002Fknowledge-apply.py` | `.lokf\u002Fscripts\u002Fknowledge-apply.py` (`chmod +x`): the half of the apply script that parses YAML. The `.sh` runs it through `uv run`. |\n| `templates\u002Fscripts\u002Fknowledge-report.sh` | `.lokf\u002Fscripts\u002Fknowledge-report.sh` (`chmod +x`): what a program can say about the bundle, so that no model works it out. It prints each concept's trust label, the health line, ktl-librarian's work list, the curator's sample, the evidence table and what a change does to the record. It scores the index-only retrieval test and counts the tracked files no concept names. ktl-curator and ktl-librarian quote it, ktl-docent quotes its own copy, and the librarian workflow fills its pull request from it. Install it even when the rest of this step is skipped: it needs bash and awk, and git only where there is one |\n| `templates\u002Fm365\u002Fknowledge-m365.sh` | `.lokf\u002Fm365\u002Fknowledge-m365.sh` (`chmod +x`): builds one Microsoft 365 Copilot custom skill per instructions file beside it, each with a snapshot of the bundle inside. The release workflow runs it and attaches each zip beside the bundle zip; what Copilot allows and what each role can be there: [references\u002Fm365.md](references\u002Fm365.md). Install it even when the rest of this step is skipped: a host with no git builds the skill by hand and uploads it, and it needs neither git nor GitHub |\n| `templates\u002Fdomain.yaml`, `templates\u002Fscripts\u002Fknowledge-federate.py`, `templates\u002Fgithub\u002Fknowledge-federation.yaml` *(a domain host only)* | `.lokf\u002Fschema\u002Fdomain.yaml`, `.lokf\u002Fscripts\u002Fknowledge-federate.py` (`chmod +x`), `.github\u002Fworkflows\u002Fknowledge-federation.yaml`: a bundle whose concepts are other bundles, the workspace built from their releases or the files their sites serve, its readers (`mcp`, `serve`, `query`) and `diff` for release notes; [references\u002Fautomation.md](references\u002Fautomation.md) says how |\n| `templates\u002Fgithub\u002Fknowledge-sync.yaml`, `templates\u002Fscripts\u002Fknowledge-sync.sh`, `templates\u002Fgithub\u002Fknowledge-sync-pull-request.md` | `.github\u002Fworkflows\u002Fknowledge-sync.yaml`, `.lokf\u002Fscripts\u002Fknowledge-sync.sh` (`chmod +x`), `.github\u002FPULL_REQUEST_TEMPLATE\u002Fknowledge-sync.md`: keep the copies and the skills pin at the newest release of the skills repository, as `templates\u002Fknowledge-sync.manifest` lists them. The workflow checks each week and opens one pull request from the template when the pin is behind, refreshed until merged; the script does the same by hand with `--pr \u003Ctag>`. Install the three wherever the librarian workflow is; [references\u002Fautomation.md](references\u002Fautomation.md) says how to set its token up |\n| `templates\u002Fm365\u002Fktl-docent-m365.md` | `.lokf\u002Fm365\u002Fktl-docent-m365.md`: the docent's instructions for Copilot, packed as that skill's `SKILL.md`. It is named after the skill, not `SKILL.md`, so no installer lists it as one; a later read-only role (the auditor) is another file beside it |\n| `templates\u002Fscripts\u002Fknowledge-ingest.py`, `templates\u002Fscripts\u002Fknowledge-ingest.sh`, `templates\u002Fgithub\u002Fknowledge-ingest.yaml`, `templates\u002Fgithub\u002Fknowledge-ingest-pull-request.md` *(a host with knowledge outside its repository)* | `.lokf\u002Fingest.yaml` (the host's own, copied from `.lokf\u002Fingest.yaml.sample`, which Step 1 lays down), `.lokf\u002Fscripts\u002Fknowledge-ingest.py` and `.lokf\u002Fscripts\u002Fknowledge-ingest.sh` (`chmod +x`), `.github\u002Fworkflows\u002Fknowledge-ingest.yaml`, `.github\u002FPULL_REQUEST_TEMPLATE\u002Fknowledge-ingest.md`. The ingest mirrors wiki pages, documents and files from other repositories into `.lokf\u002Fmirror\u002F`, and the workflow opens one pull request with what changed. [references\u002Fautomation.md](references\u002Fautomation.md) says how to set it up, and [ingest.md](https:\u002F\u002Fw3id.org\u002Fktl\u002Fdocs\u002Fingest\u002F) is the guide |\n\n**Security scanner note (Snyk W011, third-party content exposure \u002F indirect prompt injection): false positive.** `knowledge-registrar.yaml`'s `provenance` job reads `github.event.pull_request` fields and the pull request's reviews and commits from the GitHub API. It reads them for one purpose: to verify that each person a new `human:\u003Cid>` confirmation names either approved the pull request or signed the commit recording it. That is human provenance, not content. No LLM, AI agent or AI tool runs in that job, this skill never reads that data, and nothing read there is passed to a model, so there is no prompt for injected content to reach. The job's header comment says how each input is contained.\n\nThe librarian and registrar workflows and the wrapper name the bundle under both of its names, `.lokf\u002Fknowledge` and `knowledge_bundle`. With the Step 2 doorway the second pathspec matches nothing. It still covers a shared folder rearranged by hand into a real `knowledge_bundle\u002F` ([references\u002Fportability.md](references\u002Fportability.md)), because a git pathspec never traverses a symlink. The release workflow resolves `.lokf\u002Fknowledge` to the real folder before packing it. There is nothing to edit.\n\nThe registrar's `provenance` job needs no setup, but check one thing and report it here: `git config --get commit.gpgsign`, and whether `HEAD` carries a signature (`git cat-file commit HEAD | grep -qE '^gpgsig'`). If signing is off, say so. GitHub blocks self-approval, so a curator who opens their own curation pull requests passes the gate only if they sign, and otherwise every confirmation ktl-curator records will be rejected at the gate.\n\nShow the three `git config` lines from [references\u002Fgate.md](references\u002Fgate.md) and let them run those; do not run them yourself and never touch their `--global` config. The optional `KNOWLEDGE_CURATION_ENVIRONMENT` route, for a curator who cannot sign, is in the same file. It needs an Environment *with required reviewers* first, and does nothing without one.\n\nThe wrapper looks for `ktl-librarian\u002FSKILL.md` under `.agents\u002Fskills\u002F`, `.claude\u002Fskills\u002F`, `.github\u002Fskills\u002F`, then bare `skills\u002F` (a repo that publishes the skills it also uses). If this repo uses another directory, add it to the script's `candidate` list now and run the script once; a mismatch otherwise fails at scheduled-run time. [references\u002Fautomation.md](references\u002Fautomation.md) says what each file does and needs, and [references\u002Fgate.md](references\u002Fgate.md) covers the registrar, signing and the forge-free gate. On GitHub, run `uvx ktl gh plan` and show the person what it lists; `ktl gh apply` sets it once they agree ([references\u002Frepository-settings.md](references\u002Frepository-settings.md)).\n\nNothing in the host lints these files yet. Check whether the host already runs ShellCheck and `actionlint` over its tree. If it does not, say so and suggest, in one line, coverage for the nine `scripts\u002F*.sh`, `m365\u002F*.sh`, the `scripts\u002F*.py` and the six `.github\u002Fworkflows\u002F*.yaml`, so a scheduled agent's wrapper is not left unchecked. A full lint and release CI is the host's choice; `lint-and-docs.yaml` in this skill's home repository is one shape, never copied wholesale.\n\n## Step 6: hand off to ktl-librarian\n\nThe sidecar ends here. ktl-librarian's first run is a **bootstrap discovery** pass that records the repo's knowledge sources as `playbooks\u002Fknowledge-sources.md`. The librarian in turn hands off to **ktl-curator**, where a person confirms what it derived, and **ktl-docent** answers readers from the bundle, recording what it lacked for the librarian's next run. So all four skills should be installed, and **ktl-website** can publish the bundle as a site once it is worth showing. In the handoff, tell the user:\n\n- which Step 0 values were **guessed** rather than found (a fallback `\u003CBASE_IRI>` above all; every `@id` starts with it, so it needs sign-off);\n- whether Step 4 validation ran, ran as the manual fallback, or was skipped;\n- which optional pieces (`queries.http`, Step 2 pointers, Step 5 automation) were added, appended to, or left alone because they already existed;\n- whether `.lokf\u002F` is **git-tracked or gitignored**; this decides whether ktl-librarian's pull-request review and any Step 5 automation apply;\n- whether the **`knowledge_bundle` doorway** was created and, if not (Windows, no symlink support, a name already taken), the one command that makes it: `ln -s .lokf\u002Fknowledge knowledge_bundle`, `just lokf-link` from `.lokf\u002F`, or `mklink \u002FJ knowledge_bundle .lokf\\knowledge`. On a synced host, say that sync services carry `.lokf\u002F` but drop links, so the doorway is per machine. On an Obsidian vault host, say that the bundle is opened by picking `knowledge_bundle` *itself* as a vault, and the vault they already have never lists it.\n",{"name":5,"license":15,"description":7,"compatibility":24},"Requires a POSIX shell (bash; Git for Windows on Windows) and python3 or uv for placeholder substitution; uv with the lokf toolkit to validate (a manual cross-check otherwise). Any host (git or none, GitHub or another forge, Linux, macOS or Windows, a synced folder), with references\u002Fportability.md saying what each loses. Step 5's workflows are GitHub Actions.","main","5dd27759ded28d089be4e0714cada2617fd70a90","skills\u002Fktl-sidecar",0,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder","https:\u002F\u002Fw3id.org\u002Fktl","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin","2026-11-15 05:29:22",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add noelmcloughlin\u002Fknowledge-trust-ladder --skill ktl-sidecar",{"tool":39,"command":40},"bunx","bunx skills add noelmcloughlin\u002Fknowledge-trust-ladder --skill ktl-sidecar",{"tool":42,"command":43},"pnpm","pnpm dlx skills add noelmcloughlin\u002Fknowledge-trust-ladder --skill ktl-sidecar","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002FSKILL.md",true,[47,53,57,61,65,69,73,77,81,87,91,95,99,103,107,111,115,119,123,127,131,135,139,143,147,151,155,159,165,169,173,177,181,185,189,193,197,201,205,209,213,217,221,225,229,233],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"references\u002Fautomation.md","REFERENCE","参考文档",78819,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Fautomation.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"references\u002Fgate.md",28672,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Fgate.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"references\u002Fm365.md",6369,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Fm365.md",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fportability.md",18873,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Fportability.md",{"path":66,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":67,"sourceHtmlUrl":68},"references\u002Fprerequisites.md",10605,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Fprerequisites.md",{"path":70,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":71,"sourceHtmlUrl":72},"references\u002Frepository-settings.json",19868,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Frepository-settings.json",{"path":74,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002Frepository-settings.md",8090,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Freferences\u002Frepository-settings.md",{"path":78,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":79,"sourceHtmlUrl":80},"templates\u002Fdomain.yaml",5861,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fdomain.yaml",{"path":82,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":85,"sourceHtmlUrl":86},"templates\u002Fgitattributes","OTHER","其他",427,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgitattributes",{"path":88,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":89,"sourceHtmlUrl":90},"templates\u002Fgithub\u002Fknowledge-federation.yaml",28311,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-federation.yaml",{"path":92,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":93,"sourceHtmlUrl":94},"templates\u002Fgithub\u002Fknowledge-ingest-pull-request.md",1353,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-ingest-pull-request.md",{"path":96,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":97,"sourceHtmlUrl":98},"templates\u002Fgithub\u002Fknowledge-ingest.yaml",17758,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-ingest.yaml",{"path":100,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":101,"sourceHtmlUrl":102},"templates\u002Fgithub\u002Fknowledge-librarian.yaml",43624,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-librarian.yaml",{"path":104,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":105,"sourceHtmlUrl":106},"templates\u002Fgithub\u002Fknowledge-registrar.yaml",33583,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-registrar.yaml",{"path":108,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":109,"sourceHtmlUrl":110},"templates\u002Fgithub\u002Fknowledge-release.yaml",32602,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-release.yaml",{"path":112,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":113,"sourceHtmlUrl":114},"templates\u002Fgithub\u002Fknowledge-sync-pull-request.md",1059,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-sync-pull-request.md",{"path":116,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":117,"sourceHtmlUrl":118},"templates\u002Fgithub\u002Fknowledge-sync.yaml",38212,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgithub\u002Fknowledge-sync.yaml",{"path":120,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":121,"sourceHtmlUrl":122},"templates\u002Fgitignore",1457,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fgitignore",{"path":124,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":125,"sourceHtmlUrl":126},"templates\u002Fingest.yaml",3981,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fingest.yaml",{"path":128,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":129,"sourceHtmlUrl":130},"templates\u002Fjustfile",3652,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fjustfile",{"path":132,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":133,"sourceHtmlUrl":134},"templates\u002Fknowledge-sync.manifest",6802,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge-sync.manifest",{"path":136,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":137,"sourceHtmlUrl":138},"templates\u002Fknowledge\u002Findex.md",820,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge\u002Findex.md",{"path":140,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":141,"sourceHtmlUrl":142},"templates\u002Fknowledge\u002Flog.md",145,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge\u002Flog.md",{"path":144,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":145,"sourceHtmlUrl":146},"templates\u002Fknowledge\u002Fservices\u002Fexample-service-a.md",510,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge\u002Fservices\u002Fexample-service-a.md",{"path":148,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":149,"sourceHtmlUrl":150},"templates\u002Fknowledge\u002Fservices\u002Fexample-service-b.md",469,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge\u002Fservices\u002Fexample-service-b.md",{"path":152,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":153,"sourceHtmlUrl":154},"templates\u002Fknowledge\u002Fservices\u002Findex.md",234,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fknowledge\u002Fservices\u002Findex.md",{"path":156,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":157,"sourceHtmlUrl":158},"templates\u002Fllms.txt",1101,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fllms.txt",{"path":160,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":163,"sourceHtmlUrl":164},"templates\u002Fm365\u002Fknowledge-m365.sh","SCRIPT","脚本",10622,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fm365\u002Fknowledge-m365.sh",{"path":166,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":167,"sourceHtmlUrl":168},"templates\u002Fm365\u002Fktl-docent-m365.md",12692,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fm365\u002Fktl-docent-m365.md",{"path":170,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":171,"sourceHtmlUrl":172},"templates\u002Fpyproject.toml",779,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fpyproject.toml",{"path":174,"resourceType":83,"resourceTypeDesc":84,"sizeBytes":175,"sourceHtmlUrl":176},"templates\u002Fqueries.http",1739,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fqueries.http",{"path":178,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":179,"sourceHtmlUrl":180},"templates\u002Freadme-for-ai-agents.md",854,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Freadme-for-ai-agents.md",{"path":182,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":183,"sourceHtmlUrl":184},"templates\u002FREADME.md",4974,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002FREADME.md",{"path":186,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":187,"sourceHtmlUrl":188},"templates\u002Fscripts\u002Fknowledge-apply.py",86200,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-apply.py",{"path":190,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":191,"sourceHtmlUrl":192},"templates\u002Fscripts\u002Fknowledge-apply.sh",5844,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-apply.sh",{"path":194,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":195,"sourceHtmlUrl":196},"templates\u002Fscripts\u002Fknowledge-conventions.py",44264,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-conventions.py",{"path":198,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":199,"sourceHtmlUrl":200},"templates\u002Fscripts\u002Fknowledge-conventions.sh",24404,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-conventions.sh",{"path":202,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":203,"sourceHtmlUrl":204},"templates\u002Fscripts\u002Fknowledge-federate.py",232288,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-federate.py",{"path":206,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":207,"sourceHtmlUrl":208},"templates\u002Fscripts\u002Fknowledge-feedback.sh",9781,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-feedback.sh",{"path":210,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":211,"sourceHtmlUrl":212},"templates\u002Fscripts\u002Fknowledge-ingest.py",148951,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-ingest.py",{"path":214,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":215,"sourceHtmlUrl":216},"templates\u002Fscripts\u002Fknowledge-ingest.sh",5283,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-ingest.sh",{"path":218,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":219,"sourceHtmlUrl":220},"templates\u002Fscripts\u002Fknowledge-librarian.sh",26743,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-librarian.sh",{"path":222,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":223,"sourceHtmlUrl":224},"templates\u002Fscripts\u002Fknowledge-preflight.sh",33473,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-preflight.sh",{"path":226,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":227,"sourceHtmlUrl":228},"templates\u002Fscripts\u002Fknowledge-provenance.sh",29472,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-provenance.sh",{"path":230,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":231,"sourceHtmlUrl":232},"templates\u002Fscripts\u002Fknowledge-report.sh",119682,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-report.sh",{"path":234,"resourceType":161,"resourceTypeDesc":162,"sizeBytes":235,"sourceHtmlUrl":236},"templates\u002Fscripts\u002Fknowledge-sync.sh",42424,"https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-sidecar\u002Ftemplates\u002Fscripts\u002Fknowledge-sync.sh",[238,245,252,259,266],{"skillNo":239,"name":240,"nameZh":6,"description":241,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":242,"categories":243,"keywords":244,"publishedAt":19},"01M7CAWY3E1VCTG51NA14TDFD8","ktl-website","Build a browsable website for the `.lokf\u002F` knowledge bundle that ktl-sidecar installed in this repository: a Hugo site in `website\u002F`, with a page per concept and its trust label, a health page, a knowledge graph, search by trust and type, and the four `lokf export` files served beside the pages. It finds the README, the docs, the changelog, the figures, a LinkML schema, retellings and a federated workspace by itself, with no setting, and is deployed to GitHub Pages by a workflow. Use when: someone asks to publish, browse, present or deploy the knowledge bundle; wants a website, a docs site or GitHub Pages for it, or one to replace an mkdocs site; or asks to repair or update a site this skill installed. Not for writing or confirming concepts; that is ktl-librarian and ktl-curator. Not for installing the bundle itself; that is ktl-sidecar, which runs first. Keywords: website, GitHub Pages, Hugo, documentation site, knowledge graph, LinkML, gen-doc, Datasette, OKF, LOKF, trust ladder.","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-website\u002FSKILL.md",[],[],{"skillNo":246,"name":247,"nameZh":6,"description":248,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":249,"categories":250,"keywords":251,"publishedAt":19},"01M7CAWA0STSM3H14QRSAZP085","ktl-prose","Reword the concept bodies of a `.lokf\u002F` knowledge bundle into plain English, changing the wording and never a fact. Use when: someone asks for a plain-prose or plain-English pass, a restyle, shorter sentences or paragraphs, plainer words in place of jargon, or a style audit of the bundle; or says its concepts read as if an agent wrote them; or asks for a version for younger or dyslexic readers (\"for ages 8 to 12\", \"for teens\", \"explain like I'm five\"). Works between ktl-librarian and ktl-curator: it rewords only a body an agent wrote and no person confirmed, and checks by script that code, links and numbers came through unchanged. Applies the same rules to another Markdown file only when a person names it. Not for deriving, correcting or confirming what a concept claims; that is ktl-librarian \u002F ktl-curator. Keywords: plain English, plain language, readability, style guide, technical writing, copy editing, OKF, LOKF, WikiSkill, trust ladder.","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-prose\u002FSKILL.md",[],[],{"skillNo":253,"name":254,"nameZh":6,"description":255,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":256,"categories":257,"keywords":258,"publishedAt":19},"01M7CAVQD3PT1H20TQBW28BTHE","ktl-librarian","Scrape the host repository this skill sits inside and build\u002Fmaintain the `.lokf\u002F` knowledge bundle as a sidecar, compliant with the Linked Open Knowledge Format (LOKF) schema (a semantic profile of OKF). Use when: creating or updating concept files under .lokf\u002Fknowledge\u002F; adding typed relationships (isPartOf\u002FdependsOn\u002FderivedFrom\u002Fabout\u002Freferences\u002F...); choosing a LOKF class (Service\u002FMetric\u002FDataset\u002FTable\u002FPolicy\u002FPlaybook\u002FGlossaryTerm\u002F...); setting base_iri\u002Fcontext\u002Fid so frontmatter expands to JSON-LD\u002FRDF; validating the bundle with the lokf toolkit (JSON Schema plus --check-refs); converting\u002Fserving the bundle as a graph; auditing .lokf\u002F for correctness, gaps, or bugs; preparing a LOKF change for human maintainer review; or running the scheduled LLM-librarian task that keeps .lokf\u002F accurate (Karpathy rule). Keywords: Open Knowledge Format, LinkML, knowledge graph, linked data, provenance, WikiSkill, trust ladder.","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-librarian\u002FSKILL.md",[],[],{"skillNo":260,"name":261,"nameZh":6,"description":262,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":263,"categories":264,"keywords":265,"publishedAt":19},"01M7CATZBCG1SM7458HWC64B2J","ktl-docent","Answer questions about this repository from its `.lokf\u002F` knowledge bundle first, saying how far each concept used has been trusted, and explore the repository directly only when the bundle has no answer, recording that miss, or a disagreement between bundle and source, in `.lokf\u002Ffeedback.md` for the librarian and curator. Use when: someone asks what\u002Fwho\u002Fwhich\u002Fhow about the project, its services, data, policies, terms, or owners; before searching the repo directly; when an answer must say what it rests on. Not for building, fixing, or confirming concepts; that is ktl-librarian \u002F ktl-curator. Keywords: OKF, Open Knowledge Format, LOKF, LinkML, knowledge graph, question answering, citations, provenance, WikiSkill, trust ladder.","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-docent\u002FSKILL.md",[],[],{"skillNo":267,"name":268,"nameZh":6,"description":269,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":270,"categories":271,"keywords":272,"publishedAt":19},"01M7CATQB2BF90C689YDW4YMPC","ktl-curator","Help a human curator judge what the `.lokf\u002F` knowledge bundle claims. Use when: someone asks how trustworthy, current, or complete the bundle is; wants a short report of what needs a person's confirmation; wants to confirm, correct, retire, or send back a concept; sets review dates or a curation policy; or reports something the bundle got wrong or left out. Records only what the human says; it never verifies anything itself. Not for deriving or fixing concepts from the repository; that is ktl-librarian. Keywords: OKF, Open Knowledge Format, LOKF, LinkML, knowledge graph, provenance, human review, verification, audit trail, WikiSkill, trust ladder.","https:\u002F\u002Fgithub.com\u002Fnoelmcloughlin\u002Fknowledge-trust-ladder\u002Fblob\u002Fmain\u002Fskills\u002Fktl-curator\u002FSKILL.md",[],[]]