Keystone
Keystone is the guild of guilds: it holds what every other guild rests on, and each guild's lead. This skill mostly signposts. Find the guild whose purpose fits the work, open its lead, and let the lead disclose the member you need. The Keystone standard holds the rules this skill audits; ki-skills' guilds standard sets what a guild and a lead are.
Where to start
A session in a repository starts with three skills:
ki-repo for the repository itself: its .ki.toml, its shape and the skills it declares.
ki-authoring for anything written down: formats, READMEs, decisions and knowledge placement.
ki-agentic-systems for the words: what an agent, a session, a subagent or a skill is.
On a machine not yet set up, or when a skill will not activate, start with this skill's BOOTSTRAP mode below.
The guilds
Each guild's purpose, in a line:
| Guild |
What it is for |
| Keystone |
What every other guild rests on, and each guild's lead |
| Repository |
The repository contract and each kind of repository's structure |
| Work |
How work is chosen, planned, done, accepted and coordinated |
| Agentic systems |
Its words, and agents at work: subagents, delegation, and watching the field |
| Acquire |
Bringing knowledge in from outside |
| Environment |
Where agents run: tools and access, limits, and the state agent hosts leave |
| Design |
All design, technical as well as visual: how a design is shaped, before Authoring's skills write it down |
| Authoring |
Documents and writing things down: formats, READMEs, decisions, specifications, guides and diagrams |
The guild map
Generated from every skill's frontmatter, the guild it declares and the guild it leads; never edit it by hand. Each lead is also a member of Keystone, so it appears there too.
| Guild |
Lead |
Members |
| Keystone |
ki-keystone |
ki-acquire, ki-agentic-systems, ki-authoring, ki-design, ki-env, ki-knowledge-graph, ki-repo, ki-skills, ki-work |
| Acquire |
ki-acquire |
ki-acquire-chatgpt, ki-acquire-granola, ki-dodecakrisis, ki-exchange-dynamics |
| Agentic systems |
ki-agentic-systems |
ki-agentic-radar, ki-delegation, ki-delegation-orca, ki-model-radar, ki-subagents, ki-subagents-chatgpt, ki-subagents-claude |
| Authoring |
ki-authoring |
ki-decision-records, ki-diagrams, ki-guides, ki-specs |
| Design |
ki-design |
ki-design-inspiration, ki-design-system |
| Environment |
ki-env |
ki-env-binding, ki-env-binding-chatgpt, ki-env-binding-chezmoi, ki-env-binding-claude, ki-env-housekeeping, ki-env-housekeeping-chatgpt, ki-env-housekeeping-claude, ki-env-tokenomics, ki-env-tokenomics-chatgpt, ki-env-tokenomics-claude |
| Repository |
ki-repo |
ki-engineering, ki-git, ki-repo-backpack, ki-repo-dotfiles-chezmoi, ki-repo-homebrew-tap, ki-repo-kb, ki-repo-kb-activities, ki-repo-kb-live-artifacts, ki-repo-kb-principal, ki-repo-kb-streams, ki-repo-mcp, ki-repo-packages, ki-repo-project, ki-repo-specifications, ki-repo-tools, ki-repo-website, ki-repo-website-app, ki-repo-website-cloudflare, ki-repo-website-content |
| Work |
ki-work |
ki-coordination, ki-meeting, ki-trade, ki-trades, ki-work-github-issues, ki-work-linear, ki-work-package, ki-work-recurring, ki-work-roadmap |
Joining Keystone
A skill joins Keystone only when it leads a guild, or when every guild rests on it, as ki-skills and ki-knowledge-graph do. A skill that serves one guild joins that guild, however widely it is used. Keystone stays minimal; ki-skills' guilds standard has the rest of the guild rules.
Boundaries
ki-skills owns what a guild and a lead are, how skills are named and how membership is declared.
- Each lead owns its own guild: which members it has and when to use each.
ki-repo-backpack owns how a backpack publishes its skills, including the catalogue in its skills/README.md, grouped by the same guilds.
Operating modes
For help, -h, ? or no recognised mode, explain Keystone, where to start, the guilds and the joining rule without changing anything; offer a mode choice only in an interactive session.
Mode AUDIT
Run ki repo audit --skill ki-keystone --repo <repo>. In a repository with no skill collection, every criterion is not applicable. In a backpack, the audit checks that each skill declares its guild, that each guild has one lead in Keystone, and that the guild map is current; then review the joining rule and each lead's disclosure against the standard.
Mode BOOTSTRAP
bootstrap explains first-time Knowledge Islands activation through the ki CLI: ki bootstrap, installed backpacks, user and repository skill activation, native repository operations, machine readiness for coordinating work, and local backpack development. Read the bootstrap reference and follow it; it loads the bootstrap standard and the exemplars as needed. It changes no user or repository state. Route exact command and option questions to ki --help, and .ki.toml coverage to ki-repo.
Mode CONFORM
Run AUDIT, then ki repo conform --skill ki-keystone --repo <repo> --dry-run. The host may regenerate the rubric publication; regenerate the guild map with ki dev skill generate ki-keystone --write. This mode never moves a skill between guilds; that is decided, then declared in the skill's frontmatter.
Mode EDUCATE
Name the guild and the lead for the work in hand, from the guild map, and say where a session starts. For a new skill, say which guild it joins and why, under the joining rule.
Mode REFRESH
REFRESH writes only in the canonical ki-agent-backpack repository; from an installed copy, stop and redirect there. Read the sources, compare the guild purposes and the joining rule with the decisions they come from, then make and verify the smallest correction and regenerate the guild map. For the bootstrap guidance, follow the refresh steps at the end of the bootstrap reference.
1---2name: ki-keystone3ki-kind: governance4ki-applicability: baseline5ki-guild: keystone6ki-leads: keystone7ki-depends-on: []8ki-shared-dependencies: [ki-skills:rubric]9description: >10 Lead the Keystone guild, the guild of guilds: the guild map of every KI skill by guild and lead, where a session11 starts in a repository, and the rule for joining Keystone. Use to find which guild and lead skill own a piece of12 work, to audit a skill collection's guild tree, or for `bootstrap`: first-time KI setup and activation through the13 `ki` CLI, or setup and audit-activation problems. `ki-skills` owns the guild rules and skill shape.14argument-hint: 'audit <repo> | bootstrap | conform <repo> | educate <repo> | help | refresh'15metadata:16 source: https://skillmd.com/skills/knowledgeislands/ki-keystone17---1819# Keystone2021Keystone is the guild of guilds: it holds what every other guild rests on, and each guild's lead. This skill mostly signposts. Find the guild whose purpose fits the work, open its lead, and let the lead disclose the member you need. [The Keystone standard](references/standard-keystone.md) holds the rules this skill audits; `ki-skills`' guilds standard sets what a guild and a lead are.2223## Where to start2425A session in a repository starts with three skills:2627- **`ki-repo`** for the repository itself: its `.ki.toml`, its shape and the skills it declares.28- **`ki-authoring`** for anything written down: formats, READMEs, decisions and knowledge placement.29- **`ki-agentic-systems`** for the words: what an agent, a session, a subagent or a skill is.3031On a machine not yet set up, or when a skill will not activate, start with this skill's BOOTSTRAP mode below.3233## The guilds3435Each guild's purpose, in a line:3637| Guild | What it is for |38| --- | --- |39| Keystone | What every other guild rests on, and each guild's lead |40| Repository | The repository contract and each kind of repository's structure |41| Work | How work is chosen, planned, done, accepted and coordinated |42| Agentic systems | Its words, and agents at work: subagents, delegation, and watching the field |43| Acquire | Bringing knowledge in from outside |44| Environment | Where agents run: tools and access, limits, and the state agent hosts leave |45| Design | All design, technical as well as visual: how a design is shaped, before Authoring's skills write it down |46| Authoring | Documents and writing things down: formats, READMEs, decisions, specifications, guides and diagrams |4748## The guild map4950Generated from every skill's frontmatter, the guild it declares and the guild it leads; never edit it by hand. Each lead is also a member of Keystone, so it appears there too.5152<!-- ki-keystone:guild-map:start -->5354| Guild | Lead | Members |55| --- | --- | --- |56| Keystone | `ki-keystone` | `ki-acquire`, `ki-agentic-systems`, `ki-authoring`, `ki-design`, `ki-env`, `ki-knowledge-graph`, `ki-repo`, `ki-skills`, `ki-work` |57| Acquire | `ki-acquire` | `ki-acquire-chatgpt`, `ki-acquire-granola`, `ki-dodecakrisis`, `ki-exchange-dynamics` |58| Agentic systems | `ki-agentic-systems` | `ki-agentic-radar`, `ki-delegation`, `ki-delegation-orca`, `ki-model-radar`, `ki-subagents`, `ki-subagents-chatgpt`, `ki-subagents-claude` |59| Authoring | `ki-authoring` | `ki-decision-records`, `ki-diagrams`, `ki-guides`, `ki-specs` |60| Design | `ki-design` | `ki-design-inspiration`, `ki-design-system` |61| Environment | `ki-env` | `ki-env-binding`, `ki-env-binding-chatgpt`, `ki-env-binding-chezmoi`, `ki-env-binding-claude`, `ki-env-housekeeping`, `ki-env-housekeeping-chatgpt`, `ki-env-housekeeping-claude`, `ki-env-tokenomics`, `ki-env-tokenomics-chatgpt`, `ki-env-tokenomics-claude` |62| Repository | `ki-repo` | `ki-engineering`, `ki-git`, `ki-repo-backpack`, `ki-repo-dotfiles-chezmoi`, `ki-repo-homebrew-tap`, `ki-repo-kb`, `ki-repo-kb-activities`, `ki-repo-kb-live-artifacts`, `ki-repo-kb-principal`, `ki-repo-kb-streams`, `ki-repo-mcp`, `ki-repo-packages`, `ki-repo-project`, `ki-repo-specifications`, `ki-repo-tools`, `ki-repo-website`, `ki-repo-website-app`, `ki-repo-website-cloudflare`, `ki-repo-website-content` |63| Work | `ki-work` | `ki-coordination`, `ki-meeting`, `ki-trade`, `ki-trades`, `ki-work-github-issues`, `ki-work-linear`, `ki-work-package`, `ki-work-recurring`, `ki-work-roadmap` |6465<!-- ki-keystone:guild-map:end -->6667## Joining Keystone6869A skill joins Keystone only when it leads a guild, or when every guild rests on it, as `ki-skills` and `ki-knowledge-graph` do. A skill that serves one guild joins that guild, however widely it is used. Keystone stays minimal; `ki-skills`' guilds standard has the rest of the guild rules.7071## Boundaries7273- **`ki-skills`** owns what a guild and a lead are, how skills are named and how membership is declared.74- **Each lead** owns its own guild: which members it has and when to use each.75- **`ki-repo-backpack`** owns how a backpack publishes its skills, including the catalogue in its `skills/README.md`, grouped by the same guilds.7677## Operating modes7879For `help`, `-h`, `?` or no recognised mode, explain Keystone, where to start, the guilds and the joining rule without changing anything; offer a mode choice only in an interactive session.8081### Mode AUDIT8283Run `ki repo audit --skill ki-keystone --repo <repo>`. In a repository with no skill collection, every criterion is not applicable. In a backpack, the audit checks that each skill declares its guild, that each guild has one lead in Keystone, and that the guild map is current; then review the joining rule and each lead's disclosure against [the standard](references/standard-keystone.md).8485### Mode BOOTSTRAP8687`bootstrap` explains first-time Knowledge Islands activation through the `ki` CLI: `ki bootstrap`, installed backpacks, user and repository skill activation, native repository operations, machine readiness for coordinating work, and local backpack development. Read [the bootstrap reference](references/mode-bootstrap.md) and follow it; it loads [the bootstrap standard](references/standard-bootstrap.md) and [the exemplars](references/exemplars.md) as needed. It changes no user or repository state. Route exact command and option questions to `ki --help`, and `.ki.toml` coverage to `ki-repo`.8889### Mode CONFORM9091Run AUDIT, then `ki repo conform --skill ki-keystone --repo <repo> --dry-run`. The host may regenerate the rubric publication; regenerate the guild map with `ki dev skill generate ki-keystone --write`. This mode never moves a skill between guilds; that is decided, then declared in the skill's frontmatter.9293### Mode EDUCATE9495Name the guild and the lead for the work in hand, from the guild map, and say where a session starts. For a new skill, say which guild it joins and why, under the joining rule.9697### Mode REFRESH9899REFRESH writes only in the canonical `ki-agent-backpack` repository; from an installed copy, stop and redirect there. Read [the sources](references/sources.md), compare the guild purposes and the joining rule with the decisions they come from, then make and verify the smallest correction and regenerate the guild map. For the bootstrap guidance, follow the refresh steps at the end of [the bootstrap reference](references/mode-bootstrap.md).