install-user-scope

Stars0

Forks0

UpdatedJuly 11, 2026 at 17:48

Merge-safe installer that makes FABLE-HARNESS's agents/skills/hooks available at Claude Code's user scope (~/.claude), so they work across every project, not just H:\FABLE-HARNESS. Manual-only — never auto-invoked, since this touches shared, hard-to-reverse state outside this project.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

lebobo88

lebobo88/fable-harness

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Computer Occupations, All OtherComputer and Mathematical Occupations·SOC 15-1299

SKILL.md

readonly

name	install-user-scope
description	Merge-safe installer that makes FABLE-HARNESS's agents/skills/hooks available at Claude Code's user scope (~/.claude), so they work across every project, not just H:\FABLE-HARNESS. Manual-only — never auto-invoked, since this touches shared, hard-to-reverse state outside this project.
disable-model-invocation	true

/install-user-scope — merge-safe user-scope installer

This is manual-only (disable-model-invocation: true) because it writes to ~/.claude/, which other projects (e.g. pair-programmer, AgentSmith) already share and depend on. CONSTITUTION.md N11 ("user-scope install never clobbers") governs this entire skill.

What was discovered during planning (do not re-derive this — it's already confirmed)

~/.claude/agents and ~/.claude/skills are, on this machine, whole-directory symlinks into H:\pair-programmer\.claude\.... A naive "symlink our folder over theirs" install would silently destroy that project's install. ~/.claude/settings.json hooks are additive arrays already containing pair-programmer + AgentSmith entries — they must be read-merged, never overwritten.

Procedure (follow exactly, in order — do not skip the dry-run or the confirmation)

Always run the dry run first, with no exceptions:

pwsh -NoProfile -File H:\FABLE-HARNESS\.claude\scripts\install-user-scope.ps1 -DryRun

Show the full dry-run output to the user verbatim. It lists exactly which files will be converted, which per-file symlinks will be created, and how settings.json will be merged (or flags a conflict if availableModels already exists and includes fable, which requires manual resolution — never auto-resolved).
Ask the user to explicitly confirm via AskUserQuestion — something like "Apply this install-user-scope plan? This will modify ~/.claude/agents, ~/.claude/skills, and ~/.claude/settings.json." Do not proceed on an ambiguous or implied yes; this is a hard-to-reverse, shared-state action per the standing safety guidance (always confirm first for actions like this).

Only on an explicit yes, run:

pwsh -NoProfile -File H:\FABLE-HARNESS\.claude\scripts\install-user-scope.ps1 -Confirm

Report what actually changed (files created, settings.json keys merged) and remind the user that FABLE-HARNESS's agents/skills are now available from any project directory, while every prior project's install was preserved.

What this skill must NEVER do

Never run the -Confirm pass without a completed dry-run shown to the user first.
Never delete or overwrite an existing file under ~/.claude/agents or ~/.claude/skills — the installer script itself already refuses to (SKIP on any name collision), but do not attempt to work around that by deleting the pre-existing file yourself.
Never silently resolve an availableModels conflict where an existing setting already includes fable — that is a genuine policy conflict (CONSTITUTION N2) requiring the user's explicit manual decision, not an automatic merge.

More from this repository

same repository

agent-factory

lebobo88/fable-harness

Templates and risk-tier evolution policy for authoring new agents, skills, and hooks — the 3 artifact kinds this harness produces (no "mcp" kind; this harness has no MCP). Used primarily by meta-agent when extending the harness. Auto-invocable.

2026-07-110

artifact-conventions

lebobo88/fable-harness

Reference-only skill documenting where artifacts live, the 3-verdict vocabulary (pass/pass-with-notes/reject), and the Preserved-Invariants-vs-Changed-Behaviors contract for revising an existing artifact. Load before writing or revising any artifact under .fable/. Auto-invocable.

2026-07-110

constitution

lebobo88/fable-harness

Show CONSTITUTION.md's content and invariant list on request, re-run the SHA-256 hash check against CONSTITUTION.sha256 on demand, and document the amendment procedure. Useful for Claude to consult proactively as well as for a user to invoke directly.

2026-07-110

model-routing

lebobo88/fable-harness

Canonical model-tier reference and the Fable-5 manual-only enforcement protocol. Consult before writing or changing any model field (agent frontmatter, skill frontmatter, Task dispatch parameter, settings.json availableModels, env vars). Auto-invocable — any agent or skill authoring a new artifact should load this first.

2026-07-110

plan-deep

lebobo88/fable-harness

Highest-stakes planning skill using Fable-5. Manual-only — Claude can never auto-invoke this; only a user typing /plan-deep can. Use for the small number of asks big enough to warrant Fable-level structure and thinking budget (major-scope architecture, cross-cutting rewrites, irreversible decisions).

2026-07-110

plan

lebobo88/fable-harness

Everyday, auto-invocable planning skill for routine feature/bug/refactor work. Sonnet-tier — the non-Fable default. Use for most planning needs; escalate to /plan-deep (manual-only, Fable-5) only for the rare highest-stakes plan.

2026-07-110

name	install-user-scope
description	Merge-safe installer that makes FABLE-HARNESS's agents/skills/hooks available at Claude Code's user scope (~/.claude), so they work across every project, not just H:\FABLE-HARNESS. Manual-only — never auto-invoked, since this touches shared, hard-to-reverse state outside this project.
disable-model-invocation	true

/install-user-scope — merge-safe user-scope installer

What was discovered during planning (do not re-derive this — it's already confirmed)

Procedure (follow exactly, in order — do not skip the dry-run or the confirmation)

Always run the dry run first, with no exceptions:

pwsh -NoProfile -File H:\FABLE-HARNESS\.claude\scripts\install-user-scope.ps1 -DryRun

Show the full dry-run output to the user verbatim. It lists exactly which files will be converted, which per-file symlinks will be created, and how settings.json will be merged (or flags a conflict if availableModels already exists and includes fable, which requires manual resolution — never auto-resolved).
Ask the user to explicitly confirm via AskUserQuestion — something like "Apply this install-user-scope plan? This will modify ~/.claude/agents, ~/.claude/skills, and ~/.claude/settings.json." Do not proceed on an ambiguous or implied yes; this is a hard-to-reverse, shared-state action per the standing safety guidance (always confirm first for actions like this).

Only on an explicit yes, run:

pwsh -NoProfile -File H:\FABLE-HARNESS\.claude\scripts\install-user-scope.ps1 -Confirm

Report what actually changed (files created, settings.json keys merged) and remind the user that FABLE-HARNESS's agents/skills are now available from any project directory, while every prior project's install was preserved.

What this skill must NEVER do

Never run the -Confirm pass without a completed dry-run shown to the user first.
Never delete or overwrite an existing file under ~/.claude/agents or ~/.claude/skills — the installer script itself already refuses to (SKIP on any name collision), but do not attempt to work around that by deleting the pre-existing file yourself.
Never silently resolve an availableModels conflict where an existing setting already includes fable — that is a genuine policy conflict (CONSTITUTION N2) requiring the user's explicit manual decision, not an automatic merge.