@codename_inc/spectre 5.2.2 → 5.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codename_inc/spectre",
-  "version": "5.2.2",
+  "version": "5.3.0",
   "type": "module",
   "bin": {
     "spectre": "bin/spectre.js"

package/plugins/spectre/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "spectre",
-  "version": "5.2.2",
+  "version": "5.3.0",
   "description": "Agentic coding workflow with session memory. spectre guides you through Scope, Plan, Execute, Clean, Test, Rebase, and Extract phases."
 }

package/plugins/spectre/hooks/scripts/load-knowledge.mjs

@@ -7,7 +7,7 @@
  * AGENTS.override.md and returns a short visible status line.
  *
  * Reads:
- * - Apply skill from plugin: skills/apply/SKILL.md
+ * - Apply skill from plugin: skills/spectre-apply/SKILL.md
  * - Registry from project: .agents/skills/spectre-recall/references/registry.toon
  */
 
@@ -27,6 +27,13 @@ function resolvePluginSkillPath(pluginRoot, skillName, ...parts) {
     path.join(pluginRoot, 'skills', skillName, ...parts),
     path.join(pluginRoot, '..', 'skills', skillName, ...parts),
   ];
+  const legacyBareName = skillName.startsWith('spectre-') ? skillName.slice('spectre-'.length) : null;
+  if (legacyBareName) {
+    candidates.push(
+      path.join(pluginRoot, 'skills', legacyBareName, ...parts),
+      path.join(pluginRoot, '..', 'skills', legacyBareName, ...parts)
+    );
+  }
 
   for (const candidate of candidates) {
     if (fs.existsSync(candidate)) {
@@ -119,7 +126,7 @@ function main() {
   const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
   const pluginRoot = getPluginRoot();
 
-  const applySkillPath = resolvePluginSkillPath(pluginRoot, 'apply', 'SKILL.md');
+  const applySkillPath = resolvePluginSkillPath(pluginRoot, 'spectre-apply', 'SKILL.md');
 
   if (!fs.existsSync(applySkillPath)) {
     process.exit(0);
@@ -146,7 +153,11 @@ function main() {
   // Read apply skill and strip frontmatter
   let applyContent = fs.readFileSync(applySkillPath, 'utf8');
   applyContent = stripFrontmatter(applyContent);
-  applyContent = applyContent.replaceAll('.claude/skills/', '.agents/skills/').replaceAll('/spectre:', '');
+  applyContent = applyContent
+    .replaceAll('.claude/skills/', '.agents/skills/')
+    .replace(/\/spectre:([A-Za-z0-9_-]+)/g, (_match, skillName) => {
+      return skillName.startsWith('spectre-') ? skillName : `spectre-${skillName}`;
+    });
 
   if (hasProjectKnowledgeSurface(projectDir, registryPath)) {
     writeManagedOverride(

package/plugins/spectre/hooks/scripts/register_learning.mjs

@@ -174,6 +174,13 @@ function resolvePluginSkillPath(pluginRoot, skillName, ...parts) {
     path.join(pluginRoot, 'skills', skillName, ...parts),
     path.join(pluginRoot, '..', 'skills', skillName, ...parts),
   ];
+  const legacyBareName = skillName.startsWith('spectre-') ? skillName.slice('spectre-'.length) : null;
+  if (legacyBareName) {
+    candidates.push(
+      path.join(pluginRoot, 'skills', legacyBareName, ...parts),
+      path.join(pluginRoot, '..', 'skills', legacyBareName, ...parts)
+    );
+  }
 
   for (const candidate of candidates) {
     if (fs.existsSync(candidate)) {
@@ -228,7 +235,7 @@ function main() {
     // Script is at: <plugin_root>/hooks/scripts/register_learning.mjs
     pluginRoot = path.resolve(__dirname, '..', '..');
   }
-  const templatePath = resolvePluginSkillPath(pluginRoot, 'learn', 'references', 'recall-template.md');
+  const templatePath = resolvePluginSkillPath(pluginRoot, 'spectre-learn', 'references', 'recall-template.md');
 
   // Ensure directories exist
   fs.mkdirSync(registryDir, { recursive: true });

package/plugins/spectre/hooks/scripts/test_load-knowledge.mjs

@@ -23,10 +23,10 @@ function createTmpDir() {
 }
 
 function createApplySkill(pluginDir) {
-  const skillPath = path.join(pluginDir, 'skills', 'apply', 'SKILL.md');
+  const skillPath = path.join(pluginDir, 'skills', 'spectre-apply', 'SKILL.md');
   fs.mkdirSync(path.dirname(skillPath), { recursive: true });
   fs.writeFileSync(skillPath,
-    '---\nname: apply\n---\n\n# Apply Knowledge\n\n' +
+    '---\nname: spectre-apply\n---\n\n# Apply Knowledge\n\n' +
     '## How to Find Skills\n\nScan available skills.\n\n' +
     '## Workflow\n\nDo things.\n'
   );
@@ -34,10 +34,10 @@ function createApplySkill(pluginDir) {
 }
 
 function createCodexApplySkill(codexHome) {
-  const skillPath = path.join(codexHome, 'skills', 'apply', 'SKILL.md');
+  const skillPath = path.join(codexHome, 'skills', 'spectre-apply', 'SKILL.md');
   fs.mkdirSync(path.dirname(skillPath), { recursive: true });
   fs.writeFileSync(skillPath,
-    '---\nname: apply\n---\n\n# Apply Knowledge\n\n' +
+    '---\nname: spectre-apply\n---\n\n# Apply Knowledge\n\n' +
     '## How to Find Skills\n\nScan available skills.\n\n' +
     '## Workflow\n\nDo things.\n'
   );

package/plugins/spectre/hooks/scripts/test_register-learning.mjs

@@ -114,7 +114,7 @@ describe('register_learning', () => {
     const pluginRoot = path.join(tmp, 'plugin');
 
     // Create template
-    const templateDir = path.join(pluginRoot, 'skills', 'learn', 'references');
+    const templateDir = path.join(pluginRoot, 'skills', 'spectre-learn', 'references');
     fs.mkdirSync(templateDir, { recursive: true });
     fs.writeFileSync(
       path.join(templateDir, 'recall-template.md'),
@@ -146,7 +146,7 @@ describe('register_learning', () => {
     const codexHome = path.join(tmp, 'codex-home');
     const runtimeRoot = path.join(codexHome, 'spectre');
 
-    const templateDir = path.join(codexHome, 'skills', 'learn', 'references');
+    const templateDir = path.join(codexHome, 'skills', 'spectre-learn', 'references');
     fs.mkdirSync(templateDir, { recursive: true });
     fs.writeFileSync(
       path.join(templateDir, 'recall-template.md'),

package/plugins/spectre/skills/{apply → spectre-apply}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: apply
+name: spectre-apply
 description: Use when starting implementation, debugging, or feature work on a project with captured knowledge.
 user-invocable: false
 ---
@@ -21,7 +21,7 @@ DO NOT search the codebase or dispatch agents BEFORE loading relevant knowledge
 
 **When a command explicitly tells you to load a skill, you MUST call the Skill tool to load it.** Do not improvise the workflow based on what you think the skill does. The skill defines a specific workflow with precise steps, output formats, file locations, and integrations. Your improvised version will be wrong.
 
-**You are also responsible for keeping knowledge current.** After completing significant work, proactively check whether loaded skills need updating and whether new skills should be captured via `Skill(learn)`. Do NOT wait for the user to ask.
+**You are also responsible for keeping knowledge current.** After completing significant work, proactively check whether loaded skills need updating and whether new skills should be captured via `Skill(spectre-learn)`. Do NOT wait for the user to ask.
 </CRITICAL>
 
 ## Path Convention
@@ -49,7 +49,7 @@ The registry at `{{project_root}}/.claude/skills/spectre-recall/references/regis
 After completing work, check:
 
 1. **Loaded skill now outdated?** → Update it immediately
-2. **Discovered something capture-worthy?** (gotcha, pattern, decision) → Capture via `Skill(learn)`
+2. **Discovered something capture-worthy?** (gotcha, pattern, decision) → Capture via `Skill(spectre-learn)`
 3. **Changed key files, flows, or architecture?** → Update the relevant feature skill
 4. **Made a decision with non-obvious rationale?** → Capture before the session ends
 

package/plugins/spectre/skills/{architecture_review → spectre-architecture_review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: architecture_review
+name: spectre-architecture_review
 description: 👻 | Conduct principal architecture review
 user-invocable: true
 ---

package/plugins/spectre/skills/{clean → spectre-clean}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: clean
+name: spectre-clean
 description: 👻 | Complete cleanup flow - clean, inspect, lint, test - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{code_review → spectre-code_review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: code_review
+name: spectre-code_review
 description: 👻 | Independent LLM Code Review - subagent
 user-invocable: true
 ---

package/plugins/spectre/skills/{create_plan → spectre-create_plan}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: create_plan
+name: spectre-create_plan
 description: 👻 | Create implementation plan from PRD - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{create_tasks → spectre-create_tasks}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: create_tasks
+name: spectre-create_tasks
 description: 👻 | Transform requirements into executable tasks - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: create_test_guide
+name: spectre-create_test_guide
 description: 👻 | Generate right-sized manual test guides - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{evaluate → spectre-evaluate}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: evaluate
+name: spectre-evaluate
 description: "\ud83d\udc7b | Architecture review + knowledge capture"
 user-invocable: true
 ---
@@ -27,7 +27,7 @@ $ARGUMENTS
 
 This command runs two activities in parallel:
 
-1. **Architecture Review** — dispatched as a background Opus 4.6 subagent via `Skill(architecture_review)` (Claude slash route: `/spectre:architecture_review`)
+1. **Architecture Review** — dispatched as a background Opus 4.6 subagent via `Skill(spectre-architecture_review)` (Claude slash route: `/spectre:architecture_review`)
 2. **Learn** — run directly by loading the `spectre-learn` skill
 
 ## Step (1/2) - Dispatch Architecture Review
@@ -44,7 +44,7 @@ This command runs two activities in parallel:
 ## Step (2/2) - Capture Learnings
 
 - **Action** — Learn: Load the spectre-learn skill and follow its workflow
-  - Load skill: `Skill(learn)`
+  - Load skill: `Skill(spectre-learn)`
   - **If** ARGUMENTS is provided: use it as the learning topic
   - **If** ARGUMENTS is empty: the skill will analyze recent conversation to identify what's worth capturing
   - Follow the full learning workflow from the skill (categorize, propose, write, register)

package/plugins/spectre/skills/{execute → spectre-execute}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: execute
+name: spectre-execute
 description: 👻 | Adaptive Wave-Based Build with Per-Wave Verification Gate
 user-invocable: true
 ---
@@ -118,7 +118,7 @@ $ARGUMENTS
 
 ## Step 2 - Cross-Wave Validate
 
-- **Action** — SpawnValidation: @analyst runs `Skill(validate)` (Claude slash route: `/spectre:validate`) with **narrowed scope**:
+- **Action** — SpawnValidation: @analyst runs `Skill(spectre-validate)` (Claude slash route: `/spectre:validate`) with **narrowed scope**:
   - Focus: cross-wave integration audit (did later waves silently break earlier waves' wiring?) + scope-creep audit (anything implemented that is NOT in the acceptance criteria?) + dead-computation sweep across the full cumulative diff
   - Skip: per-area wiring verification (already done per-wave in Step 1.3b's wiring lens)
 
@@ -126,7 +126,7 @@ $ARGUMENTS
 
 ## Step 3 - Prepare for QA
 
-- **Action** — GenerateTestGuide: @dev runs `Skill(create_test_guide)` (Claude slash route: `/spectre:create_test_guide`)
+- **Action** — GenerateTestGuide: @dev runs `Skill(spectre-create_test_guide)` (Claude slash route: `/spectre:create_test_guide`)
   - Save to `{OUT_DIR}/test_guide.md`
 
 ## Step 4 - Report

package/plugins/spectre/skills/{fix → spectre-fix}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: fix
+name: spectre-fix
 description: Investigate bugs & implement fixes - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{forget → spectre-forget}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: forget
+name: spectre-forget
 description: Clear session memory - archive all session files so next session starts fresh
 user-invocable: true
 ---

package/plugins/spectre/skills/{guide → spectre-guide}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: guide
+name: spectre-guide
 description: Use when rendering the Next Steps footer after any spectre command, suggesting next actions, or when users need guidance on which SPECTRE command to run.
 user-invocable: false
 ---

package/plugins/spectre/skills/{handoff → spectre-handoff}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: handoff
+name: spectre-handoff
 description: Save state snapshot to session_logs for session resume
 user-invocable: true
 ---

package/plugins/spectre/skills/{kickoff → spectre-kickoff}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: kickoff
+name: spectre-kickoff
 description: 👻 | Project kickoff with deep research & MVP pathfinding - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{learn → spectre-learn}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: learn
+name: spectre-learn
 description: Use when user invokes /learn or wants to save patterns, decisions, gotchas, procedures, or feature knowledge from a conversation for later re-use. Look for user requests like "please remember" or "what did we learn from this?".
 user-invocable: true
 ---
@@ -11,7 +11,7 @@ You capture durable project knowledge into Skills that Claude Code loads on-dema
 <CRITICAL>
 ## Exclusive Knowledge Handler
 
-When this skill is invoked (via `/learn`, `/spectre:learn`, or `Skill(learn)`), it is the **exclusive handler** for knowledge capture. It supersedes ALL other memory systems.
+When this skill is invoked (via `/learn`, `/spectre:learn`, or `Skill(spectre-learn)`), it is the **exclusive handler** for knowledge capture. It supersedes ALL other memory systems.
 
 **Do NOT**:
 - Write to `MEMORY.md` or any auto-memory directory

package/plugins/spectre/skills/{plan → spectre-plan}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: plan
+name: spectre-plan
 description: 👻 | Unified planning entry point - researches, assesses complexity, routes to workflow - primary agent
 user-invocable: true
 ---
@@ -23,7 +23,7 @@ Treat the current command arguments as this workflow's input. When invoked from
 
 ## MANDATORY COMPLIANCE RULES
 
-> **⚠️ NON-NEGOTIABLE**: After tier routing, this workflow MUST invoke nested workflows via the Skill tool. LIGHT must invoke `Skill(create_plan)` and `Skill(create_tasks)`; STANDARD/COMPREHENSIVE must invoke `Skill(create_plan)`, `Skill(create_tasks)`, and `Skill(plan_review)` (Claude slash route: `/spectre:create_plan`, `/spectre:create_tasks`, and `/spectre:plan_review`). Failure to invoke the required skills is a critical error. Do NOT summarize, describe, or skip these workflows. INVOKE THEM.
+> **⚠️ NON-NEGOTIABLE**: After tier routing, this workflow MUST invoke nested workflows via the Skill tool. LIGHT must invoke `Skill(spectre-create_plan)` and `Skill(spectre-create_tasks)`; STANDARD/COMPREHENSIVE must invoke `Skill(spectre-create_plan)`, `Skill(spectre-create_tasks)`, and `Skill(spectre-plan_review)` (Claude slash route: `/spectre:create_plan`, `/spectre:create_tasks`, and `/spectre:plan_review`). Failure to invoke the required skills is a critical error. Do NOT summarize, describe, or skip these workflows. INVOKE THEM.
 
 **After ANY user conversation or questions:**
 

package/plugins/spectre/skills/{plan_review → spectre-plan_review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: plan_review
+name: spectre-plan_review
 description: 👻 | Independent multi-lens review of plan.md and/or tasks.md — finds overengineering, missing verification, hallucinated deps, weak references
 user-invocable: true
 ---

package/plugins/spectre/skills/{prototype → spectre-prototype}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: prototype
+name: spectre-prototype
 description: 👻 | Generate a self-contained HTML prototype to validate a feature visually before planning - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{quick_dev → spectre-quick_dev}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: quick_dev
+name: spectre-quick_dev
 description: 👻 | Quickly scope, research, & plan s/m tasks - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{rebase → spectre-rebase}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: rebase
+name: spectre-rebase
 description: 👻 | Safe guided rebase w/conflict handling - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/spectre-recall/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: spectre-recall
+description: "👻 | Search Project Knowledge"
+user-invocable: true
+---
+
+# recall
+
+## Input Handling
+
+Treat the current command arguments as this workflow's input. When invoked from a slash command, use the forwarded `$ARGUMENTS` value.
+
+# /recall - Search Project Knowledge
+
+Read the project knowledge recall skill directly, then follow its instructions for the query below:
+
+- Claude Code path: `{{project_root}}/.claude/skills/spectre-recall/SKILL.md`
+- Codex path: `{{project_root}}/.agents/skills/spectre-recall/SKILL.md`
+
+If neither file exists, report that no project knowledge registry exists yet and suggest `/spectre:learn` after the current work produces something worth preserving.
+
+**Search query**: $ARGUMENTS

package/plugins/spectre/skills/{research → spectre-research}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: research
+name: spectre-research
 description: 👻 | Research codebase with parallel agents - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{scope → spectre-scope}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: scope
+name: spectre-scope
 description: 👻 | Interactively scope a feature or improvement, generating a complete Scope document with IN, OUT, and ANTI-SCOPE boundaries -- primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{ship → spectre-ship}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ship
+name: spectre-ship
 description: 👻 | Autonomous end-to-end: brain dump -> scope -> TDD -> commit -> rebase -> PR
 user-invocable: true
 ---

package/plugins/spectre/skills/{sweep → spectre-sweep}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: sweep
+name: spectre-sweep
 description: 👻 | Light pass cleanup - clean, lint, test, commit
 user-invocable: true
 ---

package/plugins/spectre/skills/{tdd → spectre-tdd}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: tdd
+name: spectre-tdd
 description: "Load this skill when executing TDD (Test-Driven Development) methodology. Use when implementing features via strict RED-GREEN-REFACTOR cycles, or when a prompt instructs execution via TDD."
 ---
 

package/plugins/spectre/skills/{test → spectre-test}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: test
+name: spectre-test
 description: 👻 | Risk-aware test coverage & commit - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{ux → spectre-ux}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ux
+name: spectre-ux
 description: 👻 | Define user flows, components, and UX behavior — generates the UX spec for a feature - primary agent
 user-invocable: true
 ---

package/plugins/spectre/skills/{validate → spectre-validate}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: validate
+name: spectre-validate
 description: 👻 | Comprehensive post implementation requirement validation using subagents
 user-invocable: true
 ---

package/plugins/spectre-codex/hooks/scripts/load-knowledge.mjs

@@ -7,7 +7,7 @@
  * AGENTS.override.md and returns a short visible status line.
  *
  * Reads:
- * - Apply skill from plugin: skills/apply/SKILL.md
+ * - Apply skill from plugin: skills/spectre-apply/SKILL.md
  * - Registry from project: .agents/skills/spectre-recall/references/registry.toon
  */
 
@@ -27,6 +27,13 @@ function resolvePluginSkillPath(pluginRoot, skillName, ...parts) {
     path.join(pluginRoot, 'skills', skillName, ...parts),
     path.join(pluginRoot, '..', 'skills', skillName, ...parts),
   ];
+  const legacyBareName = skillName.startsWith('spectre-') ? skillName.slice('spectre-'.length) : null;
+  if (legacyBareName) {
+    candidates.push(
+      path.join(pluginRoot, 'skills', legacyBareName, ...parts),
+      path.join(pluginRoot, '..', 'skills', legacyBareName, ...parts)
+    );
+  }
 
   for (const candidate of candidates) {
     if (fs.existsSync(candidate)) {
@@ -119,7 +126,7 @@ function main() {
   const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
   const pluginRoot = getPluginRoot();
 
-  const applySkillPath = resolvePluginSkillPath(pluginRoot, 'apply', 'SKILL.md');
+  const applySkillPath = resolvePluginSkillPath(pluginRoot, 'spectre-apply', 'SKILL.md');
 
   if (!fs.existsSync(applySkillPath)) {
     process.exit(0);
@@ -146,7 +153,11 @@ function main() {
   // Read apply skill and strip frontmatter
   let applyContent = fs.readFileSync(applySkillPath, 'utf8');
   applyContent = stripFrontmatter(applyContent);
-  applyContent = applyContent.replaceAll('.claude/skills/', '.agents/skills/').replaceAll('/spectre:', '');
+  applyContent = applyContent
+    .replaceAll('.claude/skills/', '.agents/skills/')
+    .replace(/\/spectre:([A-Za-z0-9_-]+)/g, (_match, skillName) => {
+      return skillName.startsWith('spectre-') ? skillName : `spectre-${skillName}`;
+    });
 
   if (hasProjectKnowledgeSurface(projectDir, registryPath)) {
     writeManagedOverride(

package/plugins/spectre-codex/hooks/scripts/register_learning.mjs

@@ -174,6 +174,13 @@ function resolvePluginSkillPath(pluginRoot, skillName, ...parts) {
     path.join(pluginRoot, 'skills', skillName, ...parts),
     path.join(pluginRoot, '..', 'skills', skillName, ...parts),
   ];
+  const legacyBareName = skillName.startsWith('spectre-') ? skillName.slice('spectre-'.length) : null;
+  if (legacyBareName) {
+    candidates.push(
+      path.join(pluginRoot, 'skills', legacyBareName, ...parts),
+      path.join(pluginRoot, '..', 'skills', legacyBareName, ...parts)
+    );
+  }
 
   for (const candidate of candidates) {
     if (fs.existsSync(candidate)) {
@@ -228,7 +235,7 @@ function main() {
     // Script is at: <plugin_root>/hooks/scripts/register_learning.mjs
     pluginRoot = path.resolve(__dirname, '..', '..');
   }
-  const templatePath = resolvePluginSkillPath(pluginRoot, 'learn', 'references', 'recall-template.md');
+  const templatePath = resolvePluginSkillPath(pluginRoot, 'spectre-learn', 'references', 'recall-template.md');
 
   // Ensure directories exist
   fs.mkdirSync(registryDir, { recursive: true });

package/plugins/spectre-codex/skills/{apply → spectre-apply}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "apply"
+name: "spectre-apply"
 description: "Use when starting implementation, debugging, or feature work on a project with captured knowledge."
 user-invocable: false
 ---
@@ -21,7 +21,7 @@ DO NOT search the codebase or dispatch agents BEFORE loading relevant knowledge
 
 **When a command explicitly tells you to load a skill, you MUST call the Skill tool to load it.** Do not improvise the workflow based on what you think the skill does. The skill defines a specific workflow with precise steps, output formats, file locations, and integrations. Your improvised version will be wrong.
 
-**You are also responsible for keeping knowledge current.** After completing significant work, proactively check whether loaded skills need updating and whether new skills should be captured via `Skill(learn)`. Do NOT wait for the user to ask.
+**You are also responsible for keeping knowledge current.** After completing significant work, proactively check whether loaded skills need updating and whether new skills should be captured via `Skill(spectre-learn)`. Do NOT wait for the user to ask.
 </CRITICAL>
 
 ## Path Convention
@@ -49,7 +49,7 @@ The registry at `{{project_root}}/.agents/skills/spectre-recall/references/regis
 After completing work, check:
 
 1. **Loaded skill now outdated?** → Update it immediately
-2. **Discovered something capture-worthy?** (gotcha, pattern, decision) → Capture via `Skill(learn)`
+2. **Discovered something capture-worthy?** (gotcha, pattern, decision) → Capture via `Skill(spectre-learn)`
 3. **Changed key files, flows, or architecture?** → Update the relevant feature skill
 4. **Made a decision with non-obvious rationale?** → Capture before the session ends
 

package/plugins/spectre-codex/skills/{architecture_review → spectre-architecture_review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "architecture_review"
+name: "spectre-architecture_review"
 description: "👻 | Conduct principal architecture review"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{clean → spectre-clean}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "clean"
+name: "spectre-clean"
 description: "👻 | Complete cleanup flow - clean, inspect, lint, test - primary agent"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{code_review → spectre-code_review}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "code_review"
+name: "spectre-code_review"
 description: "👻 | Independent LLM Code Review - subagent"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{create_plan → spectre-create_plan}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "create_plan"
+name: "spectre-create_plan"
 description: "👻 | Create implementation plan from PRD - primary agent"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{create_tasks → spectre-create_tasks}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "create_tasks"
+name: "spectre-create_tasks"
 description: "👻 | Transform requirements into executable tasks - primary agent"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{create_test_guide → spectre-create_test_guide}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "create_test_guide"
+name: "spectre-create_test_guide"
 description: "👻 | Generate right-sized manual test guides - primary agent"
 user-invocable: true
 ---

package/plugins/spectre-codex/skills/{evaluate → spectre-evaluate}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "evaluate"
+name: "spectre-evaluate"
 description: "👻 | Architecture review + knowledge capture"
 user-invocable: true
 ---
@@ -27,7 +27,7 @@ $ARGUMENTS
 
 This command runs two activities in parallel:
 
-1. **Architecture Review** — dispatched as a background Opus 4.6 subagent via `Skill(architecture_review)` (Claude slash route: `architecture_review`)
+1. **Architecture Review** — dispatched as a background Opus 4.6 subagent via `Skill(spectre-architecture_review)` (Claude slash route: `spectre-architecture_review`)
 2. **Learn** — run directly by loading the `spectre-learn` skill
 
 ## Step (1/2) - Dispatch Architecture Review
@@ -44,7 +44,7 @@ This command runs two activities in parallel:
 ## Step (2/2) - Capture Learnings
 
 - **Action** — Learn: Load the spectre-learn skill and follow its workflow
-  - Load skill: `Skill(learn)`
+  - Load skill: `Skill(spectre-learn)`
   - **If** ARGUMENTS is provided: use it as the learning topic
   - **If** ARGUMENTS is empty: the skill will analyze recent conversation to identify what's worth capturing
   - Follow the full learning workflow from the skill (categorize, propose, write, register)