fit-scorer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Fit Scorer

适配度评分工具

Score each shortlisted creator on the typed STAR Suitability (S) dimension, then keep campaign-specific commercial fit in a separate prioritization matrix. The Suitability read is portable and brand-independent; the commercial matrix is not a Suitability score and never enters the SQS.

针对入围创作者，基于标准化STAR **适配度（S）**维度进行评分，然后将活动特定的商业适配性纳入单独的优先级矩阵中。适配度评估结果可迁移且独立于品牌；商业矩阵不属于适配度评分，且绝不会纳入SQS（STAR质量评分体系）。

Quick Start

快速入门

Score one influencer:

Score @[handle] for [brand/campaign] and tell me if they're a good fit

Compare and rank a shortlist:

Compare and rank these influencers for [campaign]: @influencer1, @influencer2, @influencer3

为单个网红评分：

Score @[handle] for [brand/campaign] and tell me if they're a good fit

对比并排名入围名单：

Compare and rank these influencers for [campaign]: @influencer1, @influencer2, @influencer3

Skill Contract

技能协议

Reads: brand/campaign context, target audience definition, campaign goal, and a shortlist of influencer handles (supplied by the user or carried over from
```
influencer-discovery
```
). Optional prior audience profiles from
```
memory/influencer/audience-mapper/
```
and competitor partner benchmarks from
```
memory/influencer/competitor-tracker/
```
. For rostered creators, read partnership history and audience-stat provenance from
```
memory/creators/<handle-slug>.md
```
— the creator-registry roster record — as Partnership Potential inputs.
Writes: only with explicit authorization, a report containing the typed Suitability (S) read plus a separately labeled commercial-fit comparison at
```
memory/influencer/fit-scorer/YYYY-MM-DD-<topic>.md
```
.
Promotes: only with separate authorization, evidence-backed top picks and their exact Suitability (S) read and catalog version; never promote an unscored or provisional result.
Done when:
- Every creator has all 10 Suitability items
```
S1
```
  –
```
S10
```
  explicitly Pass/Partial/Fail/Unknown/N/A with dated evidence or a gap reason.
- The typed goal/context and the Suitability item states are preserved for the gate; Unknown prevents a Suitability read.
- Any commercial-fit ranking is visibly separate from the Suitability read and cannot override a veto or missing evidence.
Primary next skill: competitor-tracker — benchmark your top-scored picks against the creators competitors already partner with.

读取内容：品牌/活动背景、目标受众定义、活动目标，以及网红账号列表（由用户提供或从
```
influencer-discovery
```
流转而来）。可选读取
```
memory/influencer/audience-mapper/
```
中的历史受众画像，以及
```
memory/influencer/competitor-tracker/
```
中的竞品合作基准数据。对于已签约创作者，从
```
memory/creators/<handle-slug>.md
```
——即creator-registry的签约记录——读取合作历史和受众数据来源，作为合作潜力评估的输入。
写入内容：仅在获得明确授权后，将包含标准化适配度（S）评估结果及单独标注的商业适配性对比的报告写入
```
memory/influencer/fit-scorer/YYYY-MM-DD-<topic>.md
```
。
推荐输出：仅在获得单独授权后，输出有证据支持的首选创作者及其准确的适配度（S）评估结果和目录版本；绝不推荐未评分或临时结果。
完成条件：
- 每位创作者的全部10项适配度指标
```
S1
```
  –
```
S10
```
  均明确标记为通过/部分通过/不通过/未知/不适用，并附带有日期的证据或缺失原因。
- 标准化目标/背景及适配度指标状态需保留以供审核；未知状态将无法生成适配度评估结果。
- 任何商业适配性排名需与适配度评估结果明确区分，且不得否决适配度评估结果或替代缺失的证据。
主要后续技能：competitor-tracker——将高分创作者与竞品已合作的创作者进行基准对比。

Handoff Summary

流转摘要

Emit the standard shape from skill-contract.md §Handoff Summary Format.

按照skill-contract.md §Handoff Summary Format输出标准格式内容。

Data Sources

数据源

This family needs no live integrations (Tier 1). Fit Scorer works end to end by asking the user for the inputs it scores — handles, audience targets, brand values, and any metrics they have. A connector sharpens the numbers but none is required.

```
~~influencer database
```
— follower counts, audience demographics, and partnership history.
```
~~social platform analytics
```
— engagement rate, comment quality samples, posting cadence, growth trend.
```
~~audience intelligence
```
— real-vs-bot follower estimates and audience overlap with your target.
Roster record (keyless Tier 1) — prior contact, response reputation, and delivery history come from
```
memory/creators/<handle-slug>.md
```
when the creator is rostered (creator-registry curates it);
```
~~CRM
```
is an optional Tier-2 sharpener for the same history when no roster record exists.

Measured YouTube inputs (free key): for YouTube candidates,

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/youtube.py" videos @handle --limit 10

supplies the engagement-authenticity inputs directly — per-video views/likes/comments against the displayed subscriber base (views-to-subs consistency, comment rate, cadence) — so those sub-scores come from Measured numbers instead of screenshots. Free

YOUTUBE_API_KEY

; shortlist vetting only (ToS refuses bulk-harvesting quota). See scripts/connectors/README.md.

With zero integrations, ask the user to supply each value the scoring tables request; the framework and weighting still produce a defensible ranking. See CONNECTORS.md for the free/keyless recipe per category.

该工具无需实时集成（Tier 1）。适配度评分工具可通过向用户请求评分所需的输入信息——账号、受众目标、品牌价值观及现有指标——完成全流程操作。连接器可优化数据准确性，但并非必需。

```
~~influencer database
```
— 粉丝数量、受众 demographics、合作历史。
```
~~social platform analytics
```
— 互动率、评论质量样本、发布频率、增长趋势。
```
~~audience intelligence
```
— 真实粉丝vs机器人粉丝估算、与目标受众的重叠度。
签约记录（无密钥Tier 1） — 当创作者已签约时，从
```
memory/creators/<handle-slug>.md
```
读取历史沟通记录、回复口碑及交付历史（由creator-registry维护）；若没有签约记录，可选使用
```
~~CRM
```
（Tier 2）优化同一历史数据。

Measured YouTube输入（免费密钥）：针对YouTube候选创作者，执行

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/connectors/youtube.py" videos @handle --limit 10

可直接获取互动真实性输入数据——每支视频的观看量/点赞量/评论量与显示订阅量的对比（观看量与订阅量的一致性、评论率、发布频率）——因此这些子分数将基于Measured数据而非截图。需使用免费

YOUTUBE_API_KEY

；仅用于入围名单审核（服务条款禁止批量采集配额）。详见scripts/connectors/README.md。

若未集成任何数据源，可请求用户提供评分表所需的各项数值；框架和权重仍可生成可靠的排名。各分类的免费/无密钥方案详见CONNECTORS.md。

Instructions

操作说明

The commercial comparison layouts live in references/scoring-templates.md. They are optional decision support, not the STAR Suitability rubric.

Lock typed context. Require the creator
```
target
```
and target version, named STAR profile/goal (
```
awareness|engagement|conversion|brand-building
```
),
```
assessment_time: forecast|actual
```
, shared campaign
```
rollup_id
```
, observation date, platform/tier/niche cohort, evidence window, material context object, and current STAR
```
catalog_version
```
— the exact typed identity the gate will reuse. If any field is absent, do not invent it: return
```
NEEDS_INPUT
```
, name the missing fields, and preserve the supplied identity unchanged for resume.
Freeze evidence. Use creator analytics, public observations, roster history, and cohort benchmarks with source/date/type/confidence. Missing or refused private access is Unknown, never Fail or Partial.
Score Suitability only. Evaluate the Suitability items
```
S1
```
–
```
S10
```
(audience composition/realness, follower-growth integrity, reach reliability, engagement health and authenticity, credibility, and portable brand/category fit) from star-benchmark.md. Campaign-specific commercial terms and availability stay in the separate matrix; cost and measured campaign conversion belong to Return (R), scored later by the gate.
Qualify critical-control evidence for handoff.
```
STAR-S2
```
covers demonstrated follower fraud / real-follower rate below the matching tier × platform × niche benchmark;
```
STAR-S6
```
covers demonstrated bought, coordinated, or pod-based engagement. Brand safety is the gate's Trust control
```
STAR-T3
```
, not a Suitability item. Mark an item Fail only from qualifying evidence, label it a potential gate finding, and operationally hold outreach while it stands. Do not call it a verified veto or apply the SQS cap/business verdict here; the auditor owns those decisions when it rolls up the full STAR run.
Record the Suitability read for the gate. Capture the
```
S1
```
–
```
S10
```
states with source/date/type/confidence as the portable Suitability (S) read. The creator-content-auditor gate folds this read into the full STAR run and runs the deterministic scorer for the profile-weighted SQS — this skill does not run the scorer or emit the SQS. Unknown means applicable evidence is missing and prevents a Suitability read; never soften Unknown to Partial or hand-calculate a composite.
Build the separate commercial matrix when requested. Use audience-to-campaign fit, content style, campaign-specific brand/category fit, commercial terms, availability, and partnership potential. Label its 1-5 total
```
commercial_fit_score
```
; it is not a Suitability score, cannot clear a Suitability veto, and never enters the SQS.
Rank transparently. Show the Suitability (S) read (or coverage/interval), critical controls, commercial fit separately, evidence confidence, and an outreach recommendation with owner/rerun condition. Do not rank an Unknown-heavy candidate as definitively superior.
Persist only with permission. Save the report only after authorization; request separate authorization before any hot-cache promotion or creator-registry proposal.

商业对比模板位于references/scoring-templates.md。这些是可选的决策支持工具，而非STAR适配度评估准则。

锁定标准化背景：需明确创作者
```
target
```
及目标版本、指定的STAR画像/目标（
```
awareness|engagement|conversion|brand-building
```
）、
```
assessment_time: forecast|actual
```
、共享活动
```
rollup_id
```
、观察日期、平台/层级/细分领域、证据窗口、关键背景对象及当前STAR
```
catalog_version
```
——即审核将复用的标准化标识。若任何字段缺失，不得自行编造：返回
```
NEEDS_INPUT
```
，列出缺失字段，并保留已提供的标识以便后续恢复操作。
固定证据：使用创作者分析数据、公开观察结果、签约历史及细分领域基准数据，并标注来源/日期/类型/可信度。缺失或无法获取的隐私数据标记为未知，不得标记为不通过或部分通过。
仅评估适配度：基于star-benchmark.md评估适配度指标
```
S1
```
–
```
S10
```
（受众构成/真实性、粉丝增长诚信度、触达可靠性、互动健康度与真实性、可信度、可迁移的品牌/品类适配性）。活动特定的商业条款和可用性需纳入单独矩阵；成本及活动转化效果属于Return（R）维度，后续由审核环节评分。
为流转确认关键控制证据：
```
STAR-S2
```
涵盖已证实的粉丝欺诈/真实粉丝率低于对应层级×平台×细分领域基准值；
```
STAR-S6
```
涵盖已证实的购买、协调或群组式互动。品牌安全属于审核环节的Trust控制指标
```
STAR-T3
```
，而非适配度指标。仅基于合格证据标记指标为不通过，标注为潜在审核发现，并在该状态存续期间暂停推广邀约。不得在此处称为已验证否决或应用SQS上限/业务结论；审核环节在汇总完整STAR流程时将负责这些决策。
为审核环节记录适配度评估结果：记录
```
S1
```
–
```
S10
```
的状态及来源/日期/类型/可信度，作为可迁移的适配度（S）评估结果。creator-content-auditor审核环节将该评估结果纳入完整STAR流程，并针对画像加权的SQS运行确定性评分工具——本技能不运行评分工具或输出SQS。未知状态表示相关证据缺失，将无法生成适配度评估结果；不得将未知状态弱化标记为部分通过或手动计算综合分数。
按需构建单独的商业矩阵：使用受众与活动的适配度、内容风格、活动特定的品牌/品类适配性、商业条款、可用性及合作潜力。标记其1-5分的
```
commercial_fit_score
```
；该分数不属于适配度评分，无法推翻适配度否决，且绝不会纳入SQS。
透明排名：展示适配度（S）评估结果（或覆盖范围/区间）、关键控制指标、单独的商业适配度、证据可信度，以及带有负责人/重评条件的推广邀约建议。不得将未知指标较多的候选创作者列为明确的优先选项。
仅在获得许可后留存数据：仅在获得授权后保存报告；在进行任何热缓存推荐或creator-registry提案前需单独请求授权。

Compact Example

简洁示例

User: "Compare @ecofashionista, @greenwardrobe, @sustainablesarah for our sustainable fashion brand (goal: conversion)."

Output: Each creator receives

S1

–

S10

item states under the same campaign

rollup_id

; a Suitability (S) read exists only at complete applicable coverage, while the separate commercial matrix explains campaign-specific terms and availability. A verified below-benchmark real-follower rate marks

STAR-S2

Fail and holds outreach; refused access stays Unknown and prevents the read. Only creator-content-auditor may apply the later STAR business verdict/cap. Persistence is offered, not assumed.

用户：“为我们的可持续时尚品牌（目标：转化）对比@ecofashionista、@greenwardrobe、@sustainablesarah。”

输出：每位创作者在同一活动

rollup_id

下获得

S1

–

S10

指标状态；仅当所有适用指标均已覆盖时才会生成适配度（S）评估结果，而单独的商业矩阵将说明活动特定条款和可用性。已证实的真实粉丝率低于基准值将标记

STAR-S2

为不通过并暂停推广邀约；无法获取数据将标记为未知并无法生成评估结果。仅creator-content-auditor可后续应用STAR业务结论/上限。需询问用户是否留存报告，不得默认留存。

Reference Materials

参考资料

references/scoring-templates.md — all per-dimension tables, final-score rollup, comparison report, custom-weighting matrix, worked example, and tips.
skill-contract.md — shared contract and handoff summary format.
state-model.md — memory tiers and save-path conventions.
CONNECTORS.md — free/keyless data recipe per connector category.
Scoring rubric: star-benchmark.md — the STAR framework, the Suitability (S) dimension this skill reads (incl. the
```
STAR-S2
```
/
```
STAR-S6
```
veto items), and the profile-weighted SQS the gate computes.
Sibling skills: influencer-discovery, competitor-tracker, audience-mapper, outreach-manager.

references/scoring-templates.md — 所有维度表格、最终分数汇总、对比报告、自定义权重矩阵、示例及提示。
skill-contract.md — 通用协议及流转摘要格式。
state-model.md — 存储层级及保存路径规范。
CONNECTORS.md — 各连接器分类的免费/无密钥方案。
评分准则：star-benchmark.md — STAR框架、本技能评估的适配度（S）维度（包括
```
STAR-S2
```
/
```
STAR-S6
```
否决指标），以及审核环节计算的画像加权SQS。
关联技能：influencer-discovery、competitor-tracker、audience-mapper、outreach-manager。