Delivery

the skill's folder in a project, and the release that wiki.toml records

Contents

1Home
2Release
3References

wiki sync copies the skill into a project, and records which release of the tool the project is on.^[1]

Home

The skill goes into the project's .agents/skills folder if there is one.^[2] Otherwise it goes into .claude/skills, which is created if it does not exist.^[2] The first is preferred because the second is often a link to it, and writing through the link would write the same place twice.^[2]

The skill lands in a folder named after itself, and a file is rewritten only when its text has changed.^[3] A file that a newer release no longer ships stays in the project until it is deleted by hand.^[3]

wiki sync --skill-dir names the folder instead, relative to the project, and the skill goes there whatever else exists; the folder is created if it is missing.^[4] wiki sync --no-skill records the release without writing the skill, and asking for both at once is refused.^[5]

Release

wiki sync also records, in wiki.toml, which release of the tool the project is on.^[6] It writes the version setting of the [tool] table, adding the setting or the whole table when it is missing, and changes no other setting, no line ending and no comment beside the version.^[6]

wiki check fails while that record is missing or names a different release, and it says to run wiki sync.^[7] A newer release can add a check, and a new check finds old pages; the record makes that failure expected rather than surprising.^[7]

References

src/builder/cli.py — sync() copies every markdown file under SKILL into skill_home(), then calls record_version() in src/builder/config.py.
src/builder/cli.py — skill_home() tries .agents/skills, then .claude/skills, and falls back to .claude/skills.
src/builder/cli.py — SKILL_NAME names the folder; sync() compares each file's text before writing it, and deletes nothing.
src/builder/cli.py — skill_home() joins a given folder to the project root before trying either convention.
src/builder/cli.py — sync() skips the copy when skill is false; main() puts --no-skill and --skill-dir in one mutually exclusive group.
src/builder/config.py — record_version() replaces the version line inside the [tool] table, keeping a comment after the value, adds one under its header or appends the table, writes the file's own line endings back, and refuses to write a file that would read differently anywhere outside [tool]; src/builder/cli.py — sync() prints the recorded release.
src/builder/build.py — version_problems(), called from check().

Last updated 15 September 2026Last audited 15 September 2026248 wordsabout 1 minute to read7 sources cited0 claims with no source