@tikomni/skills 0.1.1 → 0.1.2

package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json

@@ -1,7 +1,9 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tikomni/author-analysis-v2.schema.json",
   "title": "author_analysis_v2",
   "type": "object",
+  "additionalProperties": false,
   "required": [
     "author_positioning",
     "trust_model",
@@ -13,146 +15,273 @@
     "evidence_pack",
     "clone_guidance"
   ],
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "themeCluster": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "keywords"],
+      "properties": {
+        "name": { "type": "string" },
+        "keywords": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "tensionItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "surface", "deep_reason", "strategic_implication"],
+      "properties": {
+        "label": { "type": "string" },
+        "surface": { "type": "string" },
+        "deep_reason": { "type": "string" },
+        "strategic_implication": { "type": "string" }
+      }
+    },
+    "representativeWork": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform_work_id", "title", "bucket"],
+      "properties": {
+        "platform_work_id": { "type": "string" },
+        "title": { "type": "string" },
+        "bucket": { "type": "string" }
+      }
+    }
+  },
   "properties": {
     "author_positioning": {
       "type": "object",
-      "required": ["role", "audience", "problem", "value"],
+      "additionalProperties": false,
+      "required": [
+        "one_liner",
+        "author_type",
+        "primary_role",
+        "secondary_roles",
+        "target_audience",
+        "core_problem_solved",
+        "core_value_proposition",
+        "evidence"
+      ],
       "properties": {
-        "role": { "type": "string" },
-        "audience": { "type": "string" },
-        "problem": { "type": "string" },
-        "value": { "type": "string" }
-      },
-      "additionalProperties": false
+        "one_liner": { "type": "string" },
+        "author_type": { "type": "string" },
+        "primary_role": { "type": "string" },
+        "secondary_roles": { "$ref": "#/$defs/stringArray" },
+        "target_audience": { "type": "string" },
+        "core_problem_solved": { "type": "string" },
+        "core_value_proposition": { "type": "string" },
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "trust_model": {
       "type": "object",
-      "required": ["trust_source", "relationship_posture", "trust_risks"],
+      "additionalProperties": false,
+      "required": [
+        "primary_trust_source",
+        "secondary_trust_sources",
+        "trust_building_mechanisms",
+        "trust_risks",
+        "relationship_posture",
+        "evidence"
+      ],
       "properties": {
-        "trust_source": { "type": "string" },
-        "relationship_posture": { "type": "string" },
-        "trust_risks": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
+        "primary_trust_source": { "type": "string" },
+        "secondary_trust_sources": { "$ref": "#/$defs/stringArray" },
+        "trust_building_mechanisms": { "$ref": "#/$defs/stringArray" },
+        "trust_risks": { "$ref": "#/$defs/stringArray" },
+        "relationship_posture": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["distance", "authority_level", "affinity_level"],
+          "properties": {
+            "distance": { "type": "string" },
+            "authority_level": { "type": "string" },
+            "affinity_level": { "type": "string" }
+          }
+        },
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "cognitive_engine": {
       "type": "object",
-      "required": ["worldview", "problem_definition", "reasoning_modes"],
+      "additionalProperties": false,
+      "required": [
+        "worldview",
+        "value_priority",
+        "problem_definition_style",
+        "reasoning_modes",
+        "knowledge_sources",
+        "judgment_style",
+        "core_cognitive_actions",
+        "evidence"
+      ],
       "properties": {
         "worldview": { "type": "string" },
-        "problem_definition": { "type": "string" },
-        "reasoning_modes": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
+        "value_priority": { "$ref": "#/$defs/stringArray" },
+        "problem_definition_style": { "type": "string" },
+        "reasoning_modes": { "$ref": "#/$defs/stringArray" },
+        "knowledge_sources": { "$ref": "#/$defs/stringArray" },
+        "judgment_style": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["certainty_level", "notes"],
+          "properties": {
+            "certainty_level": { "type": "string" },
+            "notes": { "type": "string" }
+          }
+        },
+        "core_cognitive_actions": { "$ref": "#/$defs/stringArray" },
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "expression_hooks": {
       "type": "object",
-      "required": ["hook_keywords", "hook_patterns", "memorability_sources"],
+      "additionalProperties": false,
+      "required": [
+        "language_style",
+        "hook_keywords",
+        "hook_types",
+        "argument_patterns",
+        "emotion_patterns",
+        "memorability_sources",
+        "evidence"
+      ],
       "properties": {
-        "hook_keywords": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "hook_patterns": {
-          "type": "array",
-          "items": { "type": "string" }
+        "language_style": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["oral_level", "assertiveness", "emotional_intensity", "professional_density"],
+          "properties": {
+            "oral_level": { "type": "string" },
+            "assertiveness": { "type": "string" },
+            "emotional_intensity": { "type": "string" },
+            "professional_density": { "type": "string" }
+          }
         },
-        "memorability_sources": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
+        "hook_keywords": { "$ref": "#/$defs/stringArray" },
+        "hook_types": { "$ref": "#/$defs/stringArray" },
+        "argument_patterns": { "$ref": "#/$defs/stringArray" },
+        "emotion_patterns": { "$ref": "#/$defs/stringArray" },
+        "memorability_sources": { "$ref": "#/$defs/stringArray" },
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "content_mechanism": {
       "type": "object",
-      "required": ["topic_sources", "topic_goals", "winning_structures", "traffic_drivers"],
+      "additionalProperties": false,
+      "required": [
+        "topic_sources",
+        "topic_goals",
+        "winning_content_structures",
+        "repeatable_series",
+        "traffic_drivers",
+        "content_flywheel",
+        "cross_platform_variation",
+        "dominant_themes",
+        "theme_clusters",
+        "evidence"
+      ],
       "properties": {
-        "topic_sources": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "topic_goals": {
+        "topic_sources": { "$ref": "#/$defs/stringArray" },
+        "topic_goals": { "$ref": "#/$defs/stringArray" },
+        "winning_content_structures": { "$ref": "#/$defs/stringArray" },
+        "repeatable_series": { "$ref": "#/$defs/stringArray" },
+        "traffic_drivers": { "$ref": "#/$defs/stringArray" },
+        "content_flywheel": { "type": "string" },
+        "cross_platform_variation": { "type": "string" },
+        "dominant_themes": { "$ref": "#/$defs/stringArray" },
+        "theme_clusters": {
           "type": "array",
-          "items": { "type": "string" }
+          "items": { "$ref": "#/$defs/themeCluster" }
         },
-        "winning_structures": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "traffic_drivers": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "commercial_bridge": {
       "type": "object",
-      "required": ["funnel_role", "conversion_path", "commercial_risks"],
+      "additionalProperties": false,
+      "required": [
+        "content_role_in_funnel",
+        "likely_products",
+        "conversion_path",
+        "content_product_fit",
+        "business_model_signals",
+        "commercial_risks",
+        "evidence"
+      ],
       "properties": {
-        "funnel_role": { "type": "string" },
+        "content_role_in_funnel": { "$ref": "#/$defs/stringArray" },
+        "likely_products": { "$ref": "#/$defs/stringArray" },
         "conversion_path": { "type": "string" },
-        "commercial_risks": {
-          "type": "array",
-          "items": { "type": "string" }
-        }
-      },
-      "additionalProperties": false
+        "content_product_fit": { "type": "string" },
+        "business_model_signals": { "$ref": "#/$defs/stringArray" },
+        "commercial_risks": { "$ref": "#/$defs/stringArray" },
+        "evidence": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "core_tensions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["label", "surface", "deep_reason", "strategic_implication"],
-        "properties": {
-          "label": { "type": "string" },
-          "surface": { "type": "string" },
-          "deep_reason": { "type": "string" },
-          "strategic_implication": { "type": "string" }
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tensions", "most_important_tension", "evidence"],
+      "properties": {
+        "tensions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/tensionItem" }
         },
-        "additionalProperties": false
+        "most_important_tension": { "type": "string" },
+        "evidence": { "$ref": "#/$defs/stringArray" }
       }
     },
     "evidence_pack": {
       "type": "object",
-      "required": ["sample_size", "sample_confidence", "boundaries"],
+      "additionalProperties": false,
+      "required": [
+        "sample_size",
+        "sample_confidence",
+        "representative_works",
+        "top_keywords",
+        "observed_hooks",
+        "observed_ctas",
+        "observed_structures",
+        "notes"
+      ],
       "properties": {
         "sample_size": { "type": "integer", "minimum": 0 },
         "sample_confidence": {
           "type": "string",
-          "enum": ["low", "medium", "high"]
+          "enum": ["low", "mid", "high"]
+        },
+        "representative_works": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/representativeWork" }
         },
-        "boundaries": { "type": "string" }
-      },
-      "additionalProperties": false
+        "top_keywords": { "$ref": "#/$defs/stringArray" },
+        "observed_hooks": { "$ref": "#/$defs/stringArray" },
+        "observed_ctas": { "$ref": "#/$defs/stringArray" },
+        "observed_structures": { "$ref": "#/$defs/stringArray" },
+        "notes": { "$ref": "#/$defs/stringArray" }
+      }
     },
     "clone_guidance": {
       "type": "object",
-      "required": ["copyable_elements", "non_copyable_elements", "danger_zones", "if_only_learn_one_thing"],
+      "additionalProperties": false,
+      "required": [
+        "copyable_elements",
+        "non_copyable_elements",
+        "borrowable_flavor",
+        "danger_zones",
+        "if_only_learn_one_thing"
+      ],
       "properties": {
-        "copyable_elements": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "non_copyable_elements": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
-        "danger_zones": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
+        "copyable_elements": { "$ref": "#/$defs/stringArray" },
+        "non_copyable_elements": { "$ref": "#/$defs/stringArray" },
+        "borrowable_flavor": { "$ref": "#/$defs/stringArray" },
+        "danger_zones": { "$ref": "#/$defs/stringArray" },
         "if_only_learn_one_thing": { "type": "string" }
-      },
-      "additionalProperties": false
+      }
     }
-  },
-  "additionalProperties": false
+  }
 }

package/skills/creator-analysis/references/workflow.md

@@ -3,16 +3,21 @@
 ## Main Flow
 
 1. Collect creator fact fields.
-2. Collect the content set and write a fact card for each work.
+2. Collect the content set.
 3. Run batch ASR for video items.
 4. Exclude works with `analysis_eligibility=incomplete` from downstream analysis.
-5. Run full aggregation, bucketing, and sampling.
+5. Run normalization, aggregation, bucketing, and sampling.
 6. Run one batch explanation step for sampled works.
 7. Generate `author_analysis_v2`.
-8. Return the creator card, work cards, and aggregated conclusions.
+8. Write author sample cards for all retrieved works.
+9. Write sampled enhanced cards for sampled works only.
+10. Write the creator card.
+11. Return the creator card, author sample cards, sampled enhanced cards, and aggregated conclusions.
 
 ## Required Rules
 
 - Do not run per-work LLM deep analysis.
 - `sampled_work_explanations` must come from one batch stage only.
 - `author_analysis_v2` is the formal creator-level primary output.
+- Author sample cards are the fact-and-structure cards for all retrieved works.
+- Sampled enhanced cards reuse the sampled works only and add the explanation block from `sampled_work_explanations`.