wiki sync

bring the skill and the recorded release up to date

Contents

1Usage
2Options
3Output
4Exit codes
5References

wiki sync copies the skill into the project, and records in wiki.toml the release it came from.^[1] Why the skill lives in the project is described on Skill.

Usage

Either skill option may be given, but not both.^[2]

wiki sync [-h] [--root ROOT] [--wiki WIKI] [--skill-dir DIR | --no-skill]
wiki sync

Options

Option	Meaning	Default
`--skill-dir DIR`	the folder to put the skill in, relative to the project^[2]	`.agents/skills` if it exists, otherwise `.claude/skills`^[3]
`--no-skill`	record the release without writing the skill^[4]	the skill is written

Output

It names each file it wrote, leaving out any already up to date, then the release it recorded.^[5] It deletes nothing, so a file a newer release no longer ships stays where it is.^[5] In a project with an .agents/skills folder:^[5]

wiki: wrote .agents/skills/writing-wiki-pages/SKILL.md
wiki: wrote .agents/skills/writing-wiki-pages/references/naming-and-grammar.md
wiki: wrote .agents/skills/writing-wiki-pages/references/page-standard.md
wiki: wrote .agents/skills/writing-wiki-pages/references/reference-pages.md
wiki: wrote .agents/skills/writing-wiki-pages/references/reference-standard.md
wiki: wiki.toml records wiki-builder 0.1.0

With --no-skill, it says so in place of the files:^[5]

wiki: the skill was left out, as asked
wiki: wiki.toml records wiki-builder 0.1.0

When wiki.toml has a [tool] table with no version line, nothing is recorded, although the last line still says it was.^[6]

Exit codes

Code	Condition	Message
`0`	the release is recorded^[7]	`wiki: wiki.toml records wiki-builder 0.1.0`
`1`	there is no `wiki.toml` to record it in; the skill has already been written, and is not listed^[7]	wiki: there is no wiki.toml in /path/to/notes/docs/wiki; write one with a [site] name and at least one [[section]], then run `wiki sync` again
`2`	both skill options are given; the one given second is named first^[7]	`wiki sync: error: argument --skill-dir: not allowed with argument --no-skill`
`2`	there is no wiki where it was pointed^[7]	`wiki: no wiki at nowhere`

References

src/builder/cli.py — sync(), and record_version() in src/builder/config.py.
src/builder/cli.py — main() puts --skill-dir and --no-skill in one mutually exclusive group; skill_home() joins a given folder to the project.
src/builder/cli.py — skill_home() tries .agents/skills, then .claude/skills, and falls back to .claude/skills.
src/builder/cli.py — main() declares --no-skill off by default, and run() passes skill=not args.no_skill to sync(), which writes the skill only when asked and records the release either way.
src/builder/cli.py — sync() prints each file it wrote, the line for a skill left out and the recorded release, and deletes nothing.
src/builder/config.py — record_version() replaces the first line starting version after [tool], and adds nothing when no such line follows.
src/builder/cli.py — main() returns 2 with no wiki and 1 for a WikiError, and argparse exits 2 when both options are given; sync() copies the skill before record_version() in src/builder/config.py raises WikiError for a missing wiki.toml.

Last updated 14 September 2026Last audited never278 wordsabout 2 minutes to read7 sources cited0 claims with no source