Cf reload

Skill QBall-Inc/clear/skills/cf-reload

Context Layering & Engineering for Agentic Resources — Persistent memory, intelligent context, and structured project management for Claude Code

Install

npx -y skills add QBall-Inc/clear --skill cf-reload

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Reloads CLEAR context (knowledge, workpackage, plan) into the current session. Use when context is stale, files were manually edited, or recovering from context issues.

SKILL.md

3.9 KB, as published. Nobody here has run it

CLI Usage: When unsure about a CLI's interface or flags, run it with --help first. Do NOT attempt to discover functionality by reading plugin source code — doing so leads to incorrect execution from assumptions made without context of the holistic flow.

Reload CLEAR Context

This skill forces a reload of all CLEAR domain context into the current session. It re-triggers the SessionStart dispatcher (scripts/dispatchers/session-start.sh) with source: clear, refreshing session state + plan + workpackage + knowledge + sync state without reinitializing the project — see the session-management skill's "SessionStart Dispatcher Orchestration" section for the full fan-out.

The user-relevant surfaces are knowledge, workpackage, and plan (what gets injected into Claude's context); session and sync state are reloaded as supporting infrastructure.

Plugin Root Resolution

CLI commands in this skill reference $CLEAR_PLUGIN_ROOT — a .claude/settings.json env var the shell expands. The SessionStart hook persists it, but settings env vars load at session launch, so on a brand-new consumer's first session (before its next restart) the variable is empty and node "$CLEAR_PLUGIN_ROOT/build/..." fails with MODULE_NOT_FOUND.

First-session bootstrap — if $CLEAR_PLUGIN_ROOT is empty, set it inline in the same Bash call as the CLI (each Bash call is a fresh shell, so a separate export would not carry over):

export CLEAR_PLUGIN_ROOT="${CLEAR_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}"

Prepend it to the CLI in one shell line: export CLEAR_PLUGIN_ROOT="${CLEAR_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}"; <node "$CLEAR_PLUGIN_ROOT/build/..." command>. ${CLAUDE_PLUGIN_ROOT} resolves in this SKILL.md body to the actually-loaded plugin path; once the consumer restarts, $CLEAR_PLUGIN_ROOT is populated and the assignment is a harmless no-op.

When to Use This Skill

Load this skill when the user request matches ANY of these patterns:

Trigger Pattern	Example User Request
Manual edits to `.clear/` files	"I just edited my workpackage YAML, reload context"
Context seems stale or incomplete	"CLEAR context looks wrong, refresh it"
Recovery from context issues	"Context is broken, reload everything"
Changes made outside CLEAR commands	"I updated plan files manually, sync them"
Explicit reload request	"Run cf-reload"

DO NOT use for:

Project initialization or reinitializing a corrupted project (use /cf-init --force instead)
Debugging CLEAR internals or inspecting state (use /cf-debug instead)

Usage

/cf-reload

No arguments. Reloads all domain context in place.

Instructions

Step 1: Execute the context reload

Run the session-start dispatcher with source: clear to trigger a full context reload:

echo '{"source": "clear", "cwd": "'"$(pwd)"'", "session_id": "manual-reload"}' | "${CLEAR_PLUGIN_ROOT}/scripts/dispatchers/session-start.sh"

Step 2: Confirm the result

After execution, verify that:

The dispatcher ran without errors
CLEAR context has been refreshed (confirmation output from the script)

Step 3: Report to the user

Inform the user that CLEAR context (knowledge, workpackage, plan) has been reloaded. If any errors occurred during the reload, report them with the full error output.

Completion Checklist

Before returning to the user, verify:

Session-start dispatcher executed successfully with source: clear
Context reload confirmation was received from the script
No errors were produced during reload