@dzhechkov/skills-presentation-storyteller 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dzhechko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @dzhechkov/skills-presentation-storyteller
+
+Presentation Storyteller — composite skill for [Claude Code](https://claude.com/claude-code) that builds a **selling presentation with verified sources** plus a slide-by-slide **storytelling speaker script**.
+
+## What It Does
+
+From a topic / product / pitch, it produces three artifacts:
+
+1. `presentation-outline.md` — outline with the key thesis per point
+2. `presentation-full.md` — the full deck in Markdown with inline source links
+3. `sources-index.md` — index of verified sources
+
+…and a **"how to tell it"** speaker script for every slide, using storytelling frameworks (AIDA, Hero's Journey, Problem-Solution). Sources are gathered through verified research, so claims trace back to a citation.
+
+Triggers on `"сделай презентацию"`, `"presentation with storytelling"`, `"sales deck"`, `"pitch deck"`, `"продающая презентация"`.
+
+## Why
+
+A standalone, canonical home (per [ADR-0001](https://github.com/djd1m/dz-harness-hub/blob/main/docs/adr/0001-skill-canonicalization-and-dependency-model.md)) so other skills — e.g. `reverse-engineering-unicorn`'s Post-M6 pitch-deck step — can **reference it by id** instead of vendoring a copy.
+
+## How to Use
+
+```bash
+npx @dzhechkov/skills-presentation-storyteller init
+```
+
+Then in Claude Code: `/presentation-storyteller pitch for an AI onboarding assistant`.
+
+## What's Bundled
+
+| Component | Description |
+|-----------|-------------|
+| `presentation-storyteller` | Orchestrator skill (outline + full deck + speaker script) |
+| `explore` | Task clarification *(tracked vendor)* |
+| `goap-research-ed25519` | Verified-source research *(tracked vendor)* |
+| `/presentation-storyteller` | Slash command |
+
+> **Canonicalization (ADR-0001):** `presentation-storyteller` is the canonical artifact of this pack. It had a single copy in the repo (keysarium), so there was no drift to resolve. The `explore`/`goap` pair is a **sources.json-tracked** vendored copy (canonical: [`@dzhechkov/skills-analyst-manual`](https://www.npmjs.com/package/@dzhechkov/skills-analyst-manual)). Re-sync drift with `dz sync-upstream`.
+
+## CLI Commands
+
+`init` *(default)* · `update` · `remove` · `list` · `doctor` — options `--force`, `--dry-run`, `--help`, `--version`.
+
+## Also Available Via dz
+
+```bash
+dz init --select presentation-storyteller
+dz info presentation-storyteller
+```
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+'use strict';
+
+require('../src/cli.js');

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@dzhechkov/skills-presentation-storyteller",
+  "version": "0.1.0",
+  "description": "Presentation Storyteller — composite skill for Claude Code: build a selling presentation with verified sources + a slide-by-slide storytelling speaker script (AIDA / Hero's Journey / Problem-Solution)",
+  "main": "src/cli.js",
+  "bin": {
+    "skills-presentation-storyteller": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "sources.json",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "presentation",
+    "storytelling",
+    "pitch-deck",
+    "sales-deck",
+    "speaker-notes",
+    "verified-sources",
+    "slides",
+    "skills",
+    "skill-pack"
+  ],
+  "author": "dzhechko",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/skills-presentation-storyteller"
+  },
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/skills-presentation-storyteller#readme",
+  "bugs": {
+    "url": "https://github.com/djd1m/dz-harness-hub/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/sources.json

@@ -0,0 +1,19 @@
+{
+  "_note": "Per ADR-0001: presentation-storyteller is the canonical artifact of THIS pack (single source of truth; it had only one copy in the repo — keysarium — so there was no drift to resolve). The explore/goap pair is a TRACKED vendored copy. Re-sync with `dz sync-upstream`.",
+  "skills": {
+    "presentation-storyteller": {
+      "origin": "dz-original",
+      "canonical_pack": "@dzhechkov/skills-presentation-storyteller"
+    },
+    "explore": {
+      "origin": "vendored",
+      "canonical_pack": "@dzhechkov/skills-analyst-manual",
+      "upstream_path": "templates/.claude/skills/explore"
+    },
+    "goap-research-ed25519": {
+      "origin": "vendored",
+      "canonical_pack": "@dzhechkov/skills-analyst-manual",
+      "upstream_path": "templates/.claude/skills/goap-research-ed25519"
+    }
+  }
+}

package/src/cli.js

@@ -0,0 +1,107 @@
+'use strict';
+
+const path = require('path');
+const { bold, cyan, dim, green, yellow, red, info, error } = require('./utils');
+
+function showBanner() {
+  console.log('');
+  console.log(cyan('╔══════════════════════════════════════════════════════════╗'));
+  console.log(cyan('║') + bold('   PRESENTATION STORYTELLER — selling deck + speaker script') + cyan('║'));
+  console.log(cyan('║') + '   outline + full deck + "how to tell it" · verified srcs  ' + cyan('║'));
+  console.log(cyan('╚══════════════════════════════════════════════════════════╝'));
+  console.log('');
+}
+
+function getVersion() {
+  const pkg = require('../package.json');
+  return pkg.version;
+}
+
+function showHelp() {
+  console.log(bold('Usage:') + ' npx @dzhechkov/skills-presentation-storyteller ' + cyan('<command>') + dim(' [options]'));
+  console.log('');
+  console.log(bold('Commands:'));
+  console.log('  ' + green('init') + '      Install Presentation Storyteller skill pack into current project ' + dim('(default)'));
+  console.log('  ' + green('update') + '    Update Presentation Storyteller skill pack to latest version');
+  console.log('  ' + green('remove') + '    Remove Presentation Storyteller skill pack from project');
+  console.log('  ' + green('list') + '      List installed Presentation Storyteller components');
+  console.log('  ' + green('doctor') + '    Check Presentation Storyteller installation health');
+  console.log('');
+  console.log(bold('Options:'));
+  console.log('  ' + yellow('--force') + '     Overwrite existing files without prompting');
+  console.log('  ' + yellow('--dry-run') + '   Show what would be done without making changes');
+  console.log('  ' + yellow('--help, -h') + '  Show this help message');
+  console.log('  ' + yellow('--version, -v') + ' Show version number');
+  console.log('');
+  console.log(bold('Examples:'));
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-presentation-storyteller init');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-presentation-storyteller init --force');
+  console.log(dim('  $ ') + 'npx @dzhechkov/skills-presentation-storyteller doctor');
+  console.log('');
+  console.log(bold('What gets installed:'));
+  console.log('  Composite skill: presentation-storyteller (orchestrator)');
+  console.log('  Dependent skills: explore, goap-research-ed25519');
+  console.log('  Command: /presentation-storyteller');
+  console.log('');
+  console.log(bold('Self-contained:'));
+  console.log('  Bundles its dependent skills (tracked via sources.json).');
+  console.log('');
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+  const flags = { force: false, dryRun: false, targetDir: process.cwd() };
+  let command = null;
+
+  for (const arg of args) {
+    switch (arg) {
+      case '--force':    flags.force = true; break;
+      case '--dry-run':  flags.dryRun = true; break;
+      case '--help':
+      case '-h':         command = 'help'; break;
+      case '--version':
+      case '-v':         command = 'version'; break;
+      default:
+        if (arg.startsWith('-')) {
+          error(`Unknown option: ${arg}`);
+          process.exit(1);
+        } else if (command === null) {
+          command = arg;
+        } else {
+          error(`Unexpected argument: ${arg}`);
+          process.exit(1);
+        }
+        break;
+    }
+  }
+
+  return { command, flags };
+}
+
+function main() {
+  const { command, flags } = parseArgs(process.argv);
+
+  if (command === 'version') { console.log(getVersion()); return; }
+
+  showBanner();
+
+  if (command === 'help') { showHelp(); return; }
+
+  const resolvedCommand = command || 'init';
+
+  switch (resolvedCommand) {
+    case 'init':    require('./commands/init')(flags); break;
+    case 'update':  require('./commands/update')(flags); break;
+    case 'remove':  require('./commands/remove')(flags); break;
+    case 'list':    require('./commands/list')(flags); break;
+    case 'doctor':  require('./commands/doctor')(flags); break;
+    default:
+      error(`Unknown command: "${resolvedCommand}"`);
+      console.log('');
+      showHelp();
+      process.exitCode = 1;
+      break;
+  }
+}
+
+main();

package/src/commands/doctor.js

@@ -0,0 +1,340 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  green, red, yellow, cyan, bold, dim,
+  info, success, warn, error: logError,
+  fileExists, readJSON, readManifest,
+  MANIFEST_FILE, COMPONENTS,
+} = require('../utils');
+
+// ---------------------------------------------------------------------------
+// Check definitions
+// ---------------------------------------------------------------------------
+
+function check(name, fn) {
+  try {
+    const result = fn();
+    return {
+      name,
+      passed: result.passed,
+      detail: result.detail || '',
+      fix: result.fix || '',
+    };
+  } catch (err) {
+    return {
+      name,
+      passed: false,
+      detail: `Exception: ${err.message}`,
+      fix: 'Investigate the error above.',
+    };
+  }
+}
+
+function checkFilesExist(manifest, targetDir) {
+  return check('Files exist', () => {
+    const files = manifest.files || [];
+    const missing = [];
+
+    for (const relPath of files) {
+      const absPath = path.join(targetDir, relPath);
+      if (!fileExists(absPath)) {
+        missing.push(relPath);
+      }
+    }
+
+    if (missing.length === 0) {
+      return {
+        passed: true,
+        detail: `All ${files.length} manifest files present`,
+      };
+    }
+
+    return {
+      passed: false,
+      detail: `${missing.length} file(s) missing: ${missing.slice(0, 5).join(', ')}${missing.length > 5 ? '...' : ''}`,
+      fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore missing files.`,
+    };
+  });
+}
+
+function checkSkillAnalyst(targetDir) {
+  return check('Presentation Storyteller Full skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'presentation-storyteller');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/presentation-storyteller/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/presentation-storyteller/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore SKILL.md.`,
+      };
+    }
+
+    // Check for references directory
+    const refsDir = path.join(skillDir, 'references');
+    let refCount = 0;
+    if (fileExists(refsDir)) {
+      try {
+        const entries = fs.readdirSync(refsDir);
+        refCount = entries.filter((e) => e.endsWith('.md')).length;
+      } catch {
+        // ignore
+      }
+    }
+
+    return {
+      passed: true,
+      detail: `SKILL.md present, ${refCount} references`,
+    };
+  });
+}
+
+function checkSkillExplore(targetDir) {
+  return check('Explore skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'explore');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/explore/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/explore/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkSkillGoap(targetDir) {
+  return check('GOAP Research skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'goap-research-ed25519');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/goap-research-ed25519/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/goap-research-ed25519/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkSkillSolver(targetDir) {
+  return check('Problem Solver Enhanced skill', () => {
+    const skillDir = path.join(targetDir, '.claude', 'skills', 'problem-solver-enhanced');
+
+    if (!fileExists(skillDir)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/problem-solver-enhanced/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore skill.`,
+      };
+    }
+
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    if (!fileExists(skillMdPath)) {
+      return {
+        passed: false,
+        detail: '.claude/skills/problem-solver-enhanced/SKILL.md not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore SKILL.md.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: 'SKILL.md present',
+    };
+  });
+}
+
+function checkCommandPresent(targetDir) {
+  return check('Presentation Storyteller command', () => {
+    const commandsDir = path.join(targetDir, '.claude', 'commands');
+
+    if (!fileExists(commandsDir)) {
+      return {
+        passed: false,
+        detail: '.claude/commands/ directory not found',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore command.`,
+      };
+    }
+
+    let entries;
+    try {
+      entries = fs.readdirSync(commandsDir);
+    } catch {
+      return {
+        passed: false,
+        detail: 'Cannot read .claude/commands/ directory',
+        fix: 'Check directory permissions.',
+      };
+    }
+
+    const analystCommands = entries.filter(
+      (e) => e.startsWith('presentation-storyteller') && e.endsWith('.md')
+    );
+
+    if (analystCommands.length === 0) {
+      return {
+        passed: false,
+        detail: 'No Presentation Storyteller command files found (expected presentation-storyteller*.md)',
+        fix: `Run ${cyan('@dzhechkov/skills-presentation-storyteller update')} to restore command.`,
+      };
+    }
+
+    return {
+      passed: true,
+      detail: `${analystCommands.length} command(s): ${analystCommands.join(', ')}`,
+    };
+  });
+}
+
+function checkKeysariumIntegration(targetDir) {
+  return check('Keysarium integration', () => {
+    const keysariumPath = path.join(targetDir, '.keysarium.json');
+
+    if (!fileExists(keysariumPath)) {
+      return {
+        passed: true,
+        detail: 'Not installed (standalone Presentation Storyteller mode)',
+      };
+    }
+
+    const keysariumManifest = readJSON(keysariumPath);
+    if (!keysariumManifest) {
+      return {
+        passed: true,
+        detail: 'Detected but manifest unreadable',
+      };
+    }
+
+    return {
+      passed: true,
+      detail: `Active (Keysarium v${keysariumManifest.version})`,
+    };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Main command
+// ---------------------------------------------------------------------------
+
+async function run(options) {
+  const { targetDir } = options;
+  const manifestPath = path.join(targetDir, MANIFEST_FILE);
+
+  // ── a) Check manifest exists ──────────────────────────────────────────
+  if (!fileExists(manifestPath)) {
+    logError('Presentation Storyteller skill pack is not installed in this directory.');
+    info(`Run ${cyan('@dzhechkov/skills-presentation-storyteller init')} to install.`);
+    process.exit(1);
+  }
+
+  const manifest = readManifest(targetDir);
+  if (!manifest) {
+    logError(`Failed to read ${MANIFEST_FILE} \u2014 file may be corrupted.`);
+    process.exit(1);
+  }
+
+  console.log('');
+  info(bold(`Running health checks for @dzhechkov/skills-presentation-storyteller v${manifest.version}...`));
+  console.log('');
+
+  // ── b) Run all checks ─────────────────────────────────────────────────
+  const results = [
+    checkFilesExist(manifest, targetDir),
+    checkSkillAnalyst(targetDir),
+    checkSkillExplore(targetDir),
+    checkSkillGoap(targetDir),
+    checkSkillSolver(targetDir),
+    checkCommandPresent(targetDir),
+    checkKeysariumIntegration(targetDir),
+  ];
+
+  // ── c) Display results ────────────────────────────────────────────────
+  let passedCount = 0;
+  const failures = [];
+
+  for (const result of results) {
+    const icon = result.passed ? green('\u2713') : red('\u2717');
+    const statusColor = result.passed ? green : red;
+    const detailStr = result.detail ? dim(` \u2014 ${result.detail}`) : '';
+
+    console.log(`  ${icon} ${statusColor(result.name)}${detailStr}`);
+
+    if (result.passed) {
+      passedCount++;
+    } else {
+      failures.push(result);
+    }
+  }
+
+  // ── d) Summary ────────────────────────────────────────────────────────
+  console.log('');
+  const total = results.length;
+
+  if (passedCount === total) {
+    success(bold(`${passedCount}/${total} checks passed \u2014 Presentation Storyteller installation is healthy!`));
+    console.log('');
+    process.exit(0);
+  }
+
+  warn(bold(`${passedCount}/${total} checks passed`));
+  console.log('');
+
+  // ── e) Show fix suggestions ───────────────────────────────────────────
+  console.log(bold('Fix suggestions:'));
+  console.log('');
+
+  for (const failure of failures) {
+    console.log(`  ${red('\u2717')} ${bold(failure.name)}`);
+    if (failure.detail) {
+      console.log(`    ${dim(failure.detail)}`);
+    }
+    if (failure.fix) {
+      console.log(`    ${yellow('Fix:')} ${failure.fix}`);
+    }
+    console.log('');
+  }
+
+  process.exit(1);
+}
+
+module.exports = run;
+module.exports.run = run;