plugin-projector

name	plugin_projector
description	Manage Claude Code plugin projection from KairosChain SkillSets. Use when checking projection status, forcing re-projection, or verifying integrity.

Plugin Projector

Projects KairosChain SkillSet artifacts to Claude Code plugin structure.

Recommended Workflow

Check Status

plugin_project command="status" — current projection mode, timestamp, output count

Force Re-Projection

plugin_project command="project" force=true — re-project all artifacts regardless of digest

Verify Integrity

plugin_project command="verify" — check if projected files match the manifest

Automatic Projection

Projection runs automatically:

• On MCP server initialization (handle_initialize)
• After skill changes (skills_promote, skills_evolve, etc.) via hooks
• After SkillSet exchange (skillset_acquire, skillset_withdraw) via hooks

Run /reload-plugins after projection to activate new skills in Claude Code.

Cross-Project Projection (kairos-chain mode project)

Project an instruction mode from one KairosChain data directory into a different consumer project root.

Command shape

kairos-chain mode project \
  --data-dir   /path/to/source/.kairos \
  --project-root /path/to/consumer_project

• --data-dir: where the mode body is read from (<data-dir>/skills/<active_mode>.md).
• --project-root: where CLAUDE.md and .claude/kairos/instruction_mode.md are written.
• When --data-dir points outside the consumer workspace, --project-root is required (no plausible cwd default). data_dir == project_root is refused (CoincidenceRefused, v3.26.0).

Which mode gets projected

The active mode is not chosen by the CLI — it is read from instructions_mode in <data-dir>/skills/config.yml. If that says tutorial, tutorial is projected even when masa.md exists in the same skills/ directory.

To switch the active mode before projecting:

• Preferred: instructions_update(mode: "masa") MCP tool (records to blockchain).
• Direct: edit instructions_mode: in <data-dir>/skills/config.yml, then re-run mode project.

Drift between config and artifact

<data-dir>/skills/config.yml (instructions_mode) and <consumer>/.claude/kairos/instruction_mode.md can diverge silently if mode project is not re-run after a config change. The CLI output line mode : <name> v<ver> is the authoritative record of what was last projected — compare it against instructions_mode to detect drift.

After projection

Restart Claude Code in the consumer project. CLAUDE.md @-imports resolve only at session start; mid-session edits to the projected artifact do not reach Agent tool sub-agents.

Available Tools