ironflow skills

Manage the Ironflow AI skills bundled with this binary. The skills are compiled into the binary, so they match its version exactly. Write them to disk with ironflow skills sync, then wire your coding agent with ironflow skills doctor.

ironflow skills <subcommand> [flags]

Subcommands:

Subcommand	Description
sync	Write the bundled AI skills to .agents/skills
doctor	Detect coding agents and print how to wire the skills (makes no changes)

ironflow skills sync

Write the bundled AI skills to disk. By default they are written to $HOME/.agents/skills (available in every project). Use --local to vendor them into ./.agents/skills, or --dest for an explicit path. A version stamp is written so ironflow skills doctor can detect when an upgraded binary has left the on-disk skills stale. Requires a binary built with embedded skills (make embed).

ironflow skills sync [flags]

Flags:

Flag	Short	Type	Default	Description
--local		bool	false	Write to ./.agents/skills in the current project instead of $HOME
--dest		string		Explicit destination directory (overrides --local)
--force		bool	false	Replace bundled skills you have edited locally

Editing a bundled skill

Sync replaces each bundled skill directory it writes. If you have edited one — in Ironflow Desktop’s Skills page, or in any editor — sync refuses and names what it would replace:

Error: these skills in /Users/you/.agents/skills have local edits, and syncing would replace them:
  - ironflow-code

Copy anything you want to keep, then re-run with --force.

Files you added beside a bundled skill count as edits, because sync removes them too.

Skills that are not part of the bundled set are never touched, with or without --force. Only directories that exist in the binary’s embedded tree are replaced.

Upgrading Ironflow does not trigger this. “Edited” means changed since the last sync wrote it, not different from what the new binary ships — otherwise every release, which re-stamps version: in every bundled skill, would demand --force.

The comparison uses .ironflow-skills-manifest, written into the skills directory by each sync. A directory synced by a binary older than this feature has no manifest, so the first sync after upgrading prints a note that it could not check, and writes one:

Note: these skills were synced before edit-detection existed, so local edits could not be checked this time. Future syncs will detect them.

ironflow skills doctor

Detect installed coding agents and print the exact commands to point each one at the synced skills. This command only prints instructions; it never modifies any files.

ironflow skills doctor [flags]

Flags:

Flag	Short	Type	Default	Description
--local		bool	false	Target ./.agents/skills in the current project instead of $HOME
--dest		string		Explicit skills directory (overrides --local)

---