plugins/lisa-wiki-agy/skills/lisa-wiki-setup/SKILL.md
Scaffold, repair, verify, or upgrade a project's LLM Wiki from its config. Use when setting up the wiki in a new repo, fixing a broken/incomplete structure, or upgrading to a newer kernel version. Asks the wiki's purpose and README mode, renders the contract snapshot, scaffolds the canonical folders, and seeds the staff roster. Idempotent and non-destructive.
npx skillsauth add codyswanngt/lisa lisa-wiki-setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Bring a repo's wiki/ into conformance with the canonical structure from
wiki/lisa-wiki.config.json. Safe to re-run: it creates what is missing and repairs drift, but
never overwrites human-authored content.
/doctor structural checks.lisa-wiki release (--upgrade): re-render the contract snapshot and run a
compatibility report before writing.--with-ci: also install the optional GitHub Action validator (ci/lisa-wiki-validate.yml).wiki/lisa-wiki.config.json, or create it interactively. Ask for: org,
displayName, purpose (one paragraph — what this wiki is for), mode
(embedded|wrapper|standalone|subdir), categories, source layout, connectors, sensitivity,
sourceRetention, and the README mode (rich default | stub | preserve — always ask;
never select stub implicitly). If staff is absent, seed the standard roster (below) as the
default — every wiki gets the standard operating team unless the user opts out or edits it. Union
each role's owned categories into config.categories. Validate with scripts/validate-config.mjs.schema/wiki-structure.schema.json:
wiki/{index.md, log.md, start-here.md, schema/, sources/, state/, staff/, <category dirs>}.
Create only what is missing.wiki/schema/llm-wiki-contract.md from the plugin templates + config via
scripts/render-contract.mjs, stamping the kernelVersion. This snapshot keeps the wiki
self-describing without the plugin installed..gitignore via
scripts/ensure-gitignore.mjs. The block (delimited by # BEGIN: AI GUARDRAILS WIKI /
# END: AI GUARDRAILS WIKI) covers transient per-session worktrees and Lisa backup snapshots
(.claude/worktrees/, .codex/worktrees/, .lisabak/). Idempotent: re-running produces no
diff once the block is present. The block coexists with the base lisa plugin's
# BEGIN: AI GUARDRAILS block — both can be installed without overwriting each other because
the copy-contents strategy keys on the marker suffix. Wiki-wrapper repos (mode wrapper /
standalone) typically don't enable the base lisa plugin, so this step is the only path by
which they get the worktree-ignore patterns.AGENTS.md / CLAUDE.md point at the contract + plugin (thin pointers only).config.staff[] entry (the standard roster by default), generate the role's
wiki/staff/<role>.md page and its dual-runtime subagents by delegating to lisa-wiki-add-role
(running the subagents is out of scope).rich keeps install/usage +
adds the onboarding line; stub is the minimal pointer; preserve leaves it).lisa-wiki-doctor and report the verdict + any blocking items.The default operating team seeded into config.staff[] for every new wiki (Chief of Staff plus six
domain agents). Each role becomes a wiki/staff/<id>.md page and a dual-runtime subagent; the human
owner talks to Chief, who routes to the others. Owned categories are unioned into config.categories.
| id | role | owns (categories) | sensitivity |
|---|---|---|---|
| chief | Chief of Staff | projects, decisions, playbooks, open-questions | confidential |
| sally | Sales | sales | internal |
| mark | Marketing | marketing | internal |
| felix | Finance | finance | confidential |
| casey | Customer Success | customers | internal |
| parker | People | people | confidential |
| lex | Legal & Compliance | legal | confidential |
Projects may add, remove, or rename roles afterward; the standard roster is the starting point, not a constraint.
readme.mode.mode safety (wrapper/standalone).lisa-wiki-add-role, lisa-wiki-doctor, lisa-wiki-migrate, lisa-wiki-usage.
development
Prepare a machine — a fresh laptop or a throwaway container — to run coding agents, before any repository exists. Detects which of Lisa's supported agents (Claude Code, Codex, Cursor, OpenCode, Antigravity, Copilot) are already installed, asks which credential manager the machine uses (Bitwarden, 1Password, Doppler, Vault, AWS, or none), and installs only what is missing, each by its vendor's own preferred method. Idempotent, headless by default, and emits a Dockerfile for a spin-up/spin-down environment. Run it on a new machine, in a container, or before cloning anything.
tools
Provision and verify a remote execution environment for a host project — Codex Cloud today, other remote surfaces as they are added. Generates a repository-owned setup script that installs the declared toolchain, materializes secrets through lisa-secrets-access, and runs the project's own hook. Provisions by API where one exists, by driving the vendor console where one does not, and by emitting exact config otherwise — then proves the result with the same read-back regardless of which tier did the work. Use before dispatching any work with executionEnv.
tools
Bring a developer's machine in line with the toolchain the project declares. Reports every tool in remoteEnv.tools that is missing, outdated, or unpinned for this platform, and installs the missing ones into ~/.local/bin from the same pinned, checksummed entries the remote surfaces use — but only when asked. Same manifest, same pins, same installers as lisa-setup-remote-env; what differs is consent and that the pin is a floor rather than an equality. Run it on a fresh checkout, after a manifest change, or when a tool fails at the moment of use.
tools
Route one unit of work to a remote execution surface. Reads the executionEnv parameter (local by default, codex-cloud or claude-web today), verifies the environment is provisioned and bound to this repository, submits a thin skill invocation, records the task identifier to .lisa/remote-dispatch.json, and exits without polling. Routing only — the remote runs the identical skill from the identical repository. Composable and inline: other skills invoke it via the Skill tool rather than users calling it directly.