Skip to content
Skills Library
AI & agents · Automation

plugin_projector

/plugin_projector

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

Licence
MIT
Last repository change
25.10.2026

Assessment and security

90/ 100Class: good
Format15 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
1
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

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

Original author description

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

How it works

  1. Recommended Workflow
  2. Automatic Projection
  3. Cross-Project Projection (kairos-chain mode project)
  4. Available Tools
Original SKILL.md headings · 62 lines, 315 words
SKILL.md preview
---
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

<!-- AUTO_TOOLS -->
Files in this package (2)
  • SKILL.md 3 KB
  • hooks.json 1 KB

Versions

The database has no other skills named plugin_projector.

Database snapshot: 13.11.2026 · package version 056baa1e53b5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100kairos-chain
    Self-amendment MCP server framework with layered skill architecture and blockchain auditability. Use when managing knowledge layers, evolving skills, auditing health, or understanding KairosChain's architecture and capabilities.
  • 100okf-projection
    Creates, checks, refreshes and renders the knowledge projections of an OKF bundle (projections/<slug>/, ADR-0022), derivations of the base for a reader that are not OKF. Checks each projection.yaml, the dependency rule and drift by nature with okf_projection.py, proposes the…
  • 95skill-toggle
    Enable, disable, and manage Claude Code skills. Use when the user asks to enable/disable/toggle/manage skills, check skill status, list skills, manage skill collections, or clean up the skills directory.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.