@dzhechkov/skills-presentation-storyteller 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +53 -0
  3. package/bin/cli.js +5 -0
  4. package/package.json +47 -0
  5. package/sources.json +19 -0
  6. package/src/cli.js +107 -0
  7. package/src/commands/doctor.js +340 -0
  8. package/src/commands/init.js +168 -0
  9. package/src/commands/list.js +146 -0
  10. package/src/commands/remove.js +182 -0
  11. package/src/commands/update.js +170 -0
  12. package/src/utils.js +149 -0
  13. package/templates/.claude/commands/presentation-storyteller.md +23 -0
  14. package/templates/.claude/skills/explore/SKILL.md +218 -0
  15. package/templates/.claude/skills/explore/references/questioning-techniques.md +151 -0
  16. package/templates/.claude/skills/explore/references/task-brief-templates.md +355 -0
  17. package/templates/.claude/skills/goap-research-ed25519/SKILL.md +418 -0
  18. package/templates/.claude/skills/goap-research-ed25519/references/ed25519-verification.md +658 -0
  19. package/templates/.claude/skills/goap-research-ed25519/references/research-actions.md +544 -0
  20. package/templates/.claude/skills/goap-research-ed25519/references/source-evaluation.md +560 -0
  21. package/templates/.claude/skills/goap-research-ed25519/scripts/ed25519_verifier.py +662 -0
  22. package/templates/.claude/skills/goap-research-ed25519/scripts/goap_planner.py +720 -0
  23. package/templates/.claude/skills/presentation-storyteller/SKILL.md +374 -0
  24. package/templates/.claude/skills/presentation-storyteller/references/example-presentation.md +273 -0
  25. package/templates/.claude/skills/presentation-storyteller/references/slide-types.md +426 -0
  26. package/templates/.claude/skills/presentation-storyteller/references/sources-index-template.md +213 -0
  27. package/templates/.claude/skills/presentation-storyteller/references/speaker-script-patterns.md +324 -0
  28. package/templates/.claude/skills/presentation-storyteller/references/storytelling-frameworks.md +270 -0
@@ -0,0 +1,560 @@
1
+ # Source Evaluation Reference (Ed25519 Enhanced)
2
+
3
+ Comprehensive criteria for assessing source credibility with cryptographic trust layers.
4
+
5
+ ## Trust Model Overview
6
+
7
+ ```
8
+ ┌─────────────────────────────────────────────────────────────┐
9
+ │ TRUST PYRAMID │
10
+ ├─────────────────────────────────────────────────────────────┤
11
+ │ │
12
+ │ ┌───────────┐ │
13
+ │ │ Level 6 │ ← Cryptographically │
14
+ │ │ VERIFIED │ Signed + Trusted Issuer │
15
+ │ └─────┬─────┘ │
16
+ │ ┌─────┴─────┐ │
17
+ │ │ Level 5 │ ← Primary Sources │
18
+ │ │ HIGHEST │ (traditional) │
19
+ │ └─────┬─────┘ │
20
+ │ ┌─────────┴─────────┐ │
21
+ │ │ Level 4 │ ← Authoritative │
22
+ │ │ HIGH │ Secondary │
23
+ │ └─────────┬─────────┘ │
24
+ │ ┌─────────────┴─────────────┐ │
25
+ │ │ Level 3 │ ← Reputable │
26
+ │ │ MODERATE │ General │
27
+ │ └─────────────┬─────────────┘ │
28
+ │ ┌─────────────────┴─────────────────┐ │
29
+ │ │ Level 2 │ ← Community │
30
+ │ │ LOWER │ │
31
+ │ └─────────────────┬─────────────────┘ │
32
+ │ ┌─────────────────────┴─────────────────────┐ │
33
+ │ │ Level 1 │ ← Unverified│
34
+ │ │ MINIMAL │ │
35
+ │ └───────────────────────────────────────────┘ │
36
+ │ │
37
+ └─────────────────────────────────────────────────────────────┘
38
+ ```
39
+
40
+ ## Enhanced Reliability Scoring System
41
+
42
+ ### Level 6: Cryptographically Verified (NEW)
43
+ **Characteristics:**
44
+ - Ed25519 signature verified
45
+ - Issuer in trusted whitelist
46
+ - Content hash matches signature
47
+ - Citation chain intact
48
+
49
+ **Confidence Score:** 0.95 - 1.00
50
+
51
+ **Examples:**
52
+ - Academic papers with institutional signatures
53
+ - Government documents with digital signatures
54
+ - Press releases with verified organizational keys
55
+ - Official API responses with authentication
56
+
57
+ **Verification Requirements:**
58
+ ```python
59
+ verified = (
60
+ signature_valid AND
61
+ issuer_in_whitelist AND
62
+ content_hash_matches AND
63
+ timestamp_valid
64
+ )
65
+ ```
66
+
67
+ **Use for:** Highest-stakes claims, legal evidence, financial data
68
+
69
+ ---
70
+
71
+ ### Level 5: Highest Reliability (Traditional)
72
+ **Characteristics:**
73
+ - Primary sources (original research, official documents)
74
+ - Peer-reviewed academic publications
75
+ - Official government/institutional data
76
+ - Direct firsthand accounts from verified parties
77
+ - Original documentation (contracts, records, footage)
78
+
79
+ **Confidence Score:** 0.85 - 0.95
80
+
81
+ **Examples:**
82
+ - Published scientific papers in reputable journals
83
+ - Government statistical agencies (census, BLS, WHO)
84
+ - Official company SEC filings, press releases
85
+ - Court documents, legal filings
86
+ - Original research datasets
87
+
88
+ **Use for:** Foundational facts, statistics, direct evidence
89
+
90
+ ---
91
+
92
+ ### Level 4: High Reliability
93
+ **Characteristics:**
94
+ - Authoritative secondary sources
95
+ - Major established publications with editorial oversight
96
+ - Recognized domain experts with verifiable credentials
97
+ - Well-sourced investigative journalism
98
+ - Comprehensive industry reports from established firms
99
+
100
+ **Confidence Score:** 0.75 - 0.85
101
+
102
+ **Examples:**
103
+ - Major newspapers (NYT, WSJ, Guardian, Reuters, AP)
104
+ - Academic review articles
105
+ - Industry analysts (Gartner, McKinsey, Forrester)
106
+ - Subject matter experts' published work
107
+ - Technical documentation from official sources
108
+
109
+ **Use for:** Analysis, expert interpretation, detailed reporting
110
+
111
+ ---
112
+
113
+ ### Level 3: Moderate Reliability
114
+ **Characteristics:**
115
+ - Reputable general sources
116
+ - Industry publications and trade journals
117
+ - Established news websites
118
+ - Professional organization publications
119
+ - Verified corporate communications
120
+
121
+ **Confidence Score:** 0.60 - 0.75
122
+
123
+ **Examples:**
124
+ - Industry trade publications
125
+ - Regional newspapers
126
+ - Professional association reports
127
+ - Established tech news sites (Ars Technica, Wired)
128
+ - Company blogs (for product information)
129
+
130
+ **Use for:** Context, industry perspective, supplementary information
131
+
132
+ ---
133
+
134
+ ### Level 2: Lower Reliability
135
+ **Characteristics:**
136
+ - Community-generated content with some verification
137
+ - Personal blogs from demonstrated experts
138
+ - User forums with reputation systems
139
+ - Self-published but well-researched content
140
+ - Secondary aggregation sites
141
+
142
+ **Confidence Score:** 0.40 - 0.60
143
+
144
+ **Examples:**
145
+ - Stack Overflow (high-reputation answers)
146
+ - Medium posts by verified professionals
147
+ - Wikipedia (for general context, not citation)
148
+ - Specialized forums (verified contributors)
149
+ - News aggregators
150
+
151
+ **Use for:** Starting points, technical troubleshooting, community consensus
152
+
153
+ ---
154
+
155
+ ### Level 1: Minimal Reliability
156
+ **Characteristics:**
157
+ - Unverified sources
158
+ - Anonymous content
159
+ - Social media posts
160
+ - Content with clear commercial bias
161
+ - Rumor or speculation
162
+
163
+ **Confidence Score:** 0.00 - 0.40
164
+
165
+ **Examples:**
166
+ - Random social media posts
167
+ - Anonymous forum comments
168
+ - SEO-optimized content farms
169
+ - Press releases (for claims about competitors)
170
+ - Sponsored content disguised as editorial
171
+
172
+ **Use for:** Leads only—never cite directly without verification
173
+
174
+ ---
175
+
176
+ ## Cryptographic Trust Multipliers
177
+
178
+ When Ed25519 verification is available, apply multipliers:
179
+
180
+ | Verification Status | Multiplier | Effect |
181
+ |---------------------|------------|--------|
182
+ | Signed + Trusted Issuer | 1.25 | Level 4 → Level 5+ |
183
+ | Signed + Unknown Issuer | 1.10 | Slight boost |
184
+ | Unsigned | 1.00 | No change |
185
+ | Invalid Signature | 0.50 | Major penalty |
186
+ | Revoked Key | 0.00 | Reject source |
187
+
188
+ ### Confidence Calculation Formula
189
+
190
+ ```python
191
+ def calculate_confidence(source):
192
+ # Base reliability from level
193
+ base = source.level / 5.0 # 0.2 to 1.0
194
+
195
+ # Verification multiplier
196
+ if source.signature_verified and source.issuer_trusted:
197
+ verification_mult = 1.25
198
+ elif source.signature_verified:
199
+ verification_mult = 1.10
200
+ elif source.signature_invalid:
201
+ verification_mult = 0.50
202
+ else:
203
+ verification_mult = 1.00
204
+
205
+ # Recency factor
206
+ age_days = (now - source.timestamp).days
207
+ if age_days < 1:
208
+ recency = 1.00
209
+ elif age_days < 7:
210
+ recency = 0.95
211
+ elif age_days < 30:
212
+ recency = 0.85
213
+ elif age_days < 365:
214
+ recency = 0.70
215
+ else:
216
+ recency = 0.50
217
+
218
+ # Cap at 1.0
219
+ return min(1.0, base * verification_mult * recency)
220
+ ```
221
+
222
+ ---
223
+
224
+ ## Source Evaluation Checklist (Enhanced)
225
+
226
+ ### Authority Assessment
227
+ - [ ] Author/organization identifiable and credentialed
228
+ - [ ] Publication has editorial standards
229
+ - [ ] Expert credentials relevant to topic
230
+ - [ ] Track record of accuracy
231
+ - [ ] Institutional backing or peer review
232
+ - [ ] **Ed25519 public key registered** (NEW)
233
+ - [ ] **Issuer in trusted whitelist** (NEW)
234
+
235
+ ### Cryptographic Assessment (NEW)
236
+ - [ ] Content signed with Ed25519
237
+ - [ ] Signature verification passes
238
+ - [ ] Public key retrievable from trusted source
239
+ - [ ] Issuer domain matches claimed origin
240
+ - [ ] No key revocation notices
241
+ - [ ] Timestamp within acceptable range
242
+
243
+ ### Currency Assessment
244
+ - [ ] Publication date clearly stated
245
+ - [ ] Information current for topic type
246
+ - [ ] No signs of outdated information
247
+ - [ ] Updates/corrections noted if applicable
248
+ - [ ] **Signature timestamp recent** (NEW)
249
+
250
+ ### Coverage Assessment
251
+ - [ ] Scope appropriate to claims made
252
+ - [ ] Evidence provided for assertions
253
+ - [ ] Methodology explained for research
254
+ - [ ] Limitations acknowledged
255
+ - [ ] Multiple perspectives considered
256
+
257
+ ### Objectivity Assessment
258
+ - [ ] Potential biases identified and manageable
259
+ - [ ] Funding/sponsorship disclosed
260
+ - [ ] Language neutral (not promotional)
261
+ - [ ] Counterarguments addressed
262
+ - [ ] Commercial interests declared
263
+
264
+ ### Accuracy Assessment
265
+ - [ ] Facts verifiable through other sources
266
+ - [ ] Statistics include methodology
267
+ - [ ] Quotes attributed and checkable
268
+ - [ ] No obvious errors detected
269
+ - [ ] Sources cited properly
270
+ - [ ] **Content hash matches signature** (NEW)
271
+
272
+ ---
273
+
274
+ ## Trusted Issuer Categories
275
+
276
+ ### Tier 1: Government & Regulatory
277
+ **Trust Level:** Highest (auto-Level 5+)
278
+ ```yaml
279
+ tier1_issuers:
280
+ - "*.gov"
281
+ - "*.gov.uk"
282
+ - "*.gov.au"
283
+ - "europa.eu"
284
+ - "who.int"
285
+ - "worldbank.org"
286
+ - "imf.org"
287
+ ```
288
+
289
+ ### Tier 2: Academic & Research
290
+ **Trust Level:** Very High (Level 5)
291
+ ```yaml
292
+ tier2_issuers:
293
+ - "arxiv.org"
294
+ - "nature.com"
295
+ - "science.org"
296
+ - "sciencedirect.com"
297
+ - "springer.com"
298
+ - "ieee.org"
299
+ - "acm.org"
300
+ - "pubmed.gov"
301
+ - "*.edu"
302
+ ```
303
+
304
+ ### Tier 3: Major News & Wire Services
305
+ **Trust Level:** High (Level 4+)
306
+ ```yaml
307
+ tier3_issuers:
308
+ - "reuters.com"
309
+ - "ap.org"
310
+ - "afp.com"
311
+ - "bbc.com"
312
+ - "nytimes.com"
313
+ - "wsj.com"
314
+ - "washingtonpost.com"
315
+ - "economist.com"
316
+ - "ft.com"
317
+ ```
318
+
319
+ ### Tier 4: Industry & Professional
320
+ **Trust Level:** Moderate-High (Level 3-4)
321
+ ```yaml
322
+ tier4_issuers:
323
+ - "gartner.com"
324
+ - "mckinsey.com"
325
+ - "forrester.com"
326
+ - "deloitte.com"
327
+ - "pwc.com"
328
+ - "kpmg.com"
329
+ ```
330
+
331
+ ---
332
+
333
+ ## Domain-Specific Evaluation (Enhanced)
334
+
335
+ ### Scientific/Medical Information
336
+ **Require:**
337
+ - Peer-reviewed sources, established journals
338
+ - **Ed25519 signature from institutional key**
339
+
340
+ **Watch for:**
341
+ - Predatory journals
342
+ - Non-replicated studies
343
+ - Press releases overstating findings
344
+ - **Signatures from unrecognized institutions**
345
+
346
+ **Verify:**
347
+ - Sample sizes, methodology, conflicts of interest
348
+ - Replication status
349
+ - **Institutional key registry**
350
+
351
+ **Minimum Requirements:**
352
+ ```
353
+ Mode: strict (0.95)
354
+ Sources: ≥2 Level 5+
355
+ Signatures: Required from Tier 2 issuers
356
+ ```
357
+
358
+ ### Financial/Business Information
359
+ **Require:**
360
+ - Official filings, audited statements
361
+ - **SEC/regulatory body signatures where applicable**
362
+
363
+ **Watch for:**
364
+ - Promotional content
365
+ - Undisclosed sponsored research
366
+ - **Forged corporate signatures**
367
+
368
+ **Verify:**
369
+ - Numbers against multiple independent sources
370
+ - Check for corrections
371
+ - **Verify corporate key against official registry**
372
+
373
+ ### Technology Information
374
+ **Require:**
375
+ - Official documentation
376
+ - Benchmarks with methodology
377
+ - **Signed releases from official project keys**
378
+
379
+ **Watch for:**
380
+ - Marketing claims
381
+ - Outdated information (rapid change)
382
+ - **Compromised project keys**
383
+
384
+ **Verify:**
385
+ - Version numbers
386
+ - Test conditions
387
+ - Community feedback
388
+ - **Project key from official source (GitHub, website)**
389
+
390
+ ### Legal Information
391
+ **Require:**
392
+ - Primary legal sources
393
+ - Licensed attorney commentary
394
+ - **Court/government signatures**
395
+
396
+ **Watch for:**
397
+ - Jurisdiction-specific variations
398
+ - Outdated precedents
399
+ - **Unofficial legal advice**
400
+
401
+ **Verify:**
402
+ - Current status of laws/cases
403
+ - Jurisdictional applicability
404
+ - **Government issuer keys**
405
+
406
+ ### Political/News Information
407
+ **Require:**
408
+ - Multiple independent sources
409
+ - Primary documentation
410
+ - **≥3 Tier 3 issuer signatures**
411
+
412
+ **Watch for:**
413
+ - Partisan framing
414
+ - Selective reporting
415
+ - Anonymous sourcing
416
+ - **Single-source "scoops" without verification**
417
+
418
+ **Verify:**
419
+ - Cross-reference across ideologically diverse outlets
420
+ - **Multiple independent signatures**
421
+
422
+ ---
423
+
424
+ ## Bias Recognition Matrix (Enhanced)
425
+
426
+ | Bias Type | Indicators | Mitigation | Verification Help |
427
+ |-----------|------------|------------|-------------------|
428
+ | Commercial | Promotes product/service, lacks criticism | Seek independent reviews | Require non-commercial issuer |
429
+ | Political | One-sided framing, loaded language | Cross-reference opposing viewpoints | Multi-perspective signatures |
430
+ | Confirmation | Only supports pre-existing narrative | Actively seek disconfirming evidence | Signed dissenting sources |
431
+ | Recency | Overweights recent events | Include historical context | Check timestamp validity |
432
+ | Survivorship | Only successful examples shown | Look for failure cases | Academic peer-review sigs |
433
+ | Selection | Cherry-picked data/examples | Seek comprehensive datasets | Raw data signatures |
434
+ | **Forgery** (NEW) | Claimed sources don't exist | **Verify signatures** | Ed25519 verification |
435
+
436
+ ---
437
+
438
+ ## Verification Requirements by Claim Type (Enhanced)
439
+
440
+ ### Hard Facts (dates, numbers, names)
441
+ **Traditional:**
442
+ - Minimum: 1 Level 4+ source
443
+ - Preferred: Primary source documentation
444
+ - Red flag: Only Level 2 or below available
445
+
446
+ **With Ed25519:**
447
+ - Minimum: 1 Level 4+ source OR 1 signed Level 3 source
448
+ - Preferred: Signed primary source
449
+ - Auto-accept: Level 6 (cryptographically verified)
450
+
451
+ ### Expert Opinions
452
+ **Traditional:**
453
+ - Minimum: Attributed to named, credentialed expert
454
+ - Preferred: Multiple experts agreeing
455
+ - Red flag: Anonymous or unverifiable credentials
456
+
457
+ **With Ed25519:**
458
+ - Minimum: Signed by expert's verified key
459
+ - Preferred: Institutional countersignature
460
+ - Auto-accept: Academic institution signature
461
+
462
+ ### Statistics
463
+ **Traditional:**
464
+ - Minimum: Methodology disclosed, Level 4+ source
465
+ - Preferred: Original study/dataset accessible
466
+ - Red flag: No methodology, round numbers without context
467
+
468
+ **With Ed25519:**
469
+ - Minimum: Signed by research institution
470
+ - Preferred: Signed raw data + methodology
471
+ - Required for strict mode: Institutional signature
472
+
473
+ ### Predictions/Forecasts
474
+ - Label confidence explicitly
475
+ - Note track record of forecaster
476
+ - Present range of expert opinions
477
+ - **Never auto-accept signed predictions as facts**
478
+
479
+ ### Controversial Claims
480
+ **Traditional:**
481
+ - Minimum: 3+ independent Level 3+ sources
482
+ - Preferred: Primary evidence available
483
+ - Required: Opposing viewpoints documented
484
+
485
+ **With Ed25519:**
486
+ - Minimum: 3+ independently signed sources
487
+ - Preferred: Signed primary evidence + 2 corroborations
488
+ - Required: Signed opposing viewpoint included
489
+
490
+ ---
491
+
492
+ ## Anti-Hallucination Verification Matrix
493
+
494
+ | Claim Type | Unsigned OK? | Signature Required? | Strict Mode |
495
+ |------------|--------------|---------------------|-------------|
496
+ | Historical fact | Yes (Level 4+) | Preferred | Level 5+ |
497
+ | Current event | Level 4+ only | Required | Tier 3 sig |
498
+ | Scientific claim | Level 5+ only | Required | Tier 2 sig |
499
+ | Financial data | No | Required | Regulatory sig |
500
+ | Medical advice | No | Required | Institutional sig |
501
+ | Legal statement | No | Required | Gov/court sig |
502
+ | Expert quote | Level 4+ | Preferred | Expert key |
503
+ | Statistics | Level 5+ | Required | Methodology sig |
504
+
505
+ ---
506
+
507
+ ## Source Rejection Criteria
508
+
509
+ Automatically reject sources with:
510
+ - Invalid Ed25519 signature
511
+ - Revoked issuer key
512
+ - Timestamp >1 year old for current events
513
+ - Mismatched content hash
514
+ - Unknown issuer in strict mode
515
+ - Multiple failed verification attempts
516
+ - Blacklisted domain
517
+
518
+ ---
519
+
520
+ ## Confidence Thresholds by Research Mode
521
+
522
+ | Mode | Threshold | Unsigned Sources | Signature Required |
523
+ |------|-----------|------------------|-------------------|
524
+ | Development | 0.75 | Allowed (Level 3+) | Optional |
525
+ | Moderate | 0.85 | Limited (Level 4+) | Preferred |
526
+ | Strict | 0.95 | Rare (Level 5 only) | Required |
527
+ | Paranoid | 0.99 | Never | Always (Tier 1-2) |
528
+
529
+ ---
530
+
531
+ ## Appendix: Quick Reference Card
532
+
533
+ ```
534
+ ┌────────────────────────────────────────────────────────┐
535
+ │ SOURCE EVALUATION QUICK REFERENCE │
536
+ ├────────────────────────────────────────────────────────┤
537
+ │ ALWAYS VERIFY: │
538
+ │ ✓ Ed25519 signature (if available) │
539
+ │ ✓ Issuer against whitelist │
540
+ │ ✓ Content hash integrity │
541
+ │ ✓ Timestamp validity │
542
+ │ │
543
+ │ CONFIDENCE FORMULA: │
544
+ │ confidence = level/5 × verification × recency │
545
+ │ │
546
+ │ MINIMUM REQUIREMENTS: │
547
+ │ Facts: 1 signed source OR 2 Level 4+ unsigned │
548
+ │ Stats: Signed methodology OR Level 5+ with method │
549
+ │ Quotes: Signed OR Level 4+ with attribution │
550
+ │ │
551
+ │ RED FLAGS: │
552
+ │ ✗ Invalid/missing signature in strict mode │
553
+ │ ✗ Unknown issuer for sensitive claims │
554
+ │ ✗ Single source for controversial claims │
555
+ │ ✗ No methodology for statistics │
556
+ │ │
557
+ │ ANTI-HALLUCINATION RULE: │
558
+ │ "If you can't cite it, don't claim it" │
559
+ └────────────────────────────────────────────────────────┘
560
+ ```