@tikomni/skills 0.1.0

package/.skill-package-allowlist.txt

@@ -0,0 +1,4 @@
+# Skill directories included in distributable .skill packages
+skills/meta-capability
+skills/single-work-analysis
+skills/creator-analysis

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TikOmni
+
+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,167 @@
+# TikOmni Skills
+
+English | [中文](./README.zh-CN.md)
+
+Give AI agents direct access to TikOmni's cross-platform content retrieval and structured analysis capabilities.
+
+Works with `Codex`, `Claude Code`, and `OpenClaw`.  
+Built for content extraction, single-work analysis, creator analysis, search results, comment threads, rankings, livestreams, and structured outputs.
+
+- Website: https://tikomni.com
+- Dashboard: https://app.tikomni.com
+- API Docs: https://docs.tikomni.com
+- Releases: https://github.com/mark-ly-wang/TikOmni-Skills/releases
+
+## Why This Repo Exists
+
+`TikOmni-Skills` is the agent-facing delivery layer for TikOmni skills.
+
+Its purpose is not to be a pile of platform scripts or a few fixed templates. More importantly, it packages TikOmni's core capabilities into installable, composable skills so agents can directly:
+
+- retrieve single content items, creator pages, and content collections
+- retrieve comment threads, search results, rankings, livestreams, and product pages as concrete platform objects
+- extract titles, captions, subtitles, transcripts, and structured fields
+- generate normalized JSON outputs and Markdown cards
+- continue with analysis, summaries, and downstream knowledge workflows
+
+If TikOmni is the cross-platform capability layer, this repository is the layer that makes those capabilities usable by agents.
+
+## Supported Platforms
+
+Current coverage includes mainstream platforms such as:
+
+- Douyin, Xiaohongshu, Kuaishou, Bilibili, Weibo
+- TikTok, YouTube, Instagram, Threads, Twitter/X, Reddit, LinkedIn
+- WeChat Channels, WeChat Official Accounts, Toutiao, Xigua, Zhihu, Lemon8, Pipixia
+
+For the full catalog, see https://docs.tikomni.com
+
+## What Structured Data You Can Get
+
+Depending on the platform and endpoint, the skills can return:
+
+- author or account metadata
+- post or video basic information
+- comments and replies
+- search results, ranking results, livestream information, and commerce-related data
+- engagement metrics such as likes, comments, and shares when available
+- subtitles, transcripts, or caption text when supported
+- extractable media URLs and related assets when supported
+- route and request trace metadata for reproducibility
+
+## Skill Modules
+
+| Skill | Role | Typical tasks |
+| --- | --- | --- |
+| `meta-capability` | General capability layer | Cross-platform retrieval, route discovery, structured extraction, plus generic execution and fallback for comment threads, search, rankings, livestreams, product pages, and other supported objects |
+| `single-work-analysis` | Single-work specialist skill | Extracting and analyzing one video, note, post, or article |
+| `creator-analysis` | Creator specialist skill | Collecting and analyzing creator pages, channels, and content collections |
+
+Suggested choices:
+
+- Want to analyze one content item: install `single-work-analysis`
+- Want to analyze a creator page or content collection: install `creator-analysis`
+- Want to keep a general TikOmni entry point available: install `meta-capability`
+- Not sure which one you need yet: install `all`
+
+## More Mature High-Frequency Flows
+
+On top of the general capability layer, this repository already includes a set of more reusable high-frequency flows.
+
+Current areas with the most validation and ongoing iteration include:
+
+- Douyin single-work analysis
+- Xiaohongshu single-work analysis
+- Douyin creator-page analysis
+- Xiaohongshu creator-page analysis
+
+These flows represent the most mature and easiest-to-adopt paths today.  
+They matter, but they do not define the full capability boundary of this repository.
+
+## 30-Second Quick Start
+
+### 1. Sign up and get an API key
+
+- Website: https://tikomni.com
+- Dashboard: https://app.tikomni.com
+- API Docs: https://docs.tikomni.com
+
+### 2. Install skills
+
+If the npm package has been published, you can install directly with:
+
+```bash
+npx @tikomni/skills list
+npx @tikomni/skills install codex all
+npx @tikomni/skills install claude-code creator-analysis
+npx @tikomni/skills install openclaw meta-capability --dir "/custom/skills"
+```
+
+Default install targets:
+
+- `codex` -> `$CODEX_HOME/skills`, default `~/.codex/skills`
+- `claude-code` -> `~/.claude/skills`
+- `openclaw` -> prefers `~/.openclaw/workspace/skills`, otherwise `~/.openclaw/skills`
+
+If you are not distributing through npm yet, you can also copy the target skill folder into the runtime's `skills` directory manually.
+
+### 3. Configure environment variables
+
+Recommended workflow:
+
+- after CLI installation, the target `skills` root includes a shared [`env.example`](./env.example)
+- copy `skills/env.example` to `skills/.env`
+- add `.env.local` inside a specific skill only when that skill needs a local override
+
+Minimum required config:
+
+```bash
+TIKOMNI_API_KEY="your_real_key"
+TIKOMNI_OUTPUT_ROOT="/absolute/path/to/tikomni-output"
+TIKOMNI_CARD_ROOT="/absolute/path/to/tikomni-cards"
+```
+
+For advanced variables, see [`env.example`](./env.example).
+
+## You Can Also Ask Your Agent to Install It
+
+Instead of running commands manually, you can ask your agent directly:
+
+- "Install all TikOmni skills into Codex."
+- "Install `creator-analysis` into the Claude Code skills directory."
+- "Install `meta-capability` into OpenClaw and use `/custom/skills` as the target directory."
+
+## How to Use It After Installation
+
+Once configured, you can trigger tasks in natural language, for example:
+
+- "Extract the structured fields and subtitles from this Douyin video."
+- "Analyze this Xiaohongshu note and output a work card plus a content breakdown."
+- "Fetch the latest 20 posts from this Douyin creator page and summarize topic patterns."
+- "Analyze this Xiaohongshu account and output a creator profile with representative content traits."
+- "Search this keyword on Douyin and summarize the top 20 result patterns."
+- "Fetch this livestream's information and return a structured summary."
+
+## Versioning and Releases
+
+The current package version is declared in [`package.json`](./package.json).
+
+For release and version details, see:
+
+- [Releases](https://github.com/mark-ly-wang/TikOmni-Skills/releases)
+- [`RELEASING.md`](./RELEASING.md)
+- [`RELEASING.zh-CN.md`](./RELEASING.zh-CN.md)
+
+## Security
+
+- Never commit real API keys to Git
+- Never expose sensitive config in logs, screenshots, or outputs
+- Prefer `.env` and `.env.local` for local secret management
+
+## Links
+
+- Website: https://tikomni.com
+- Dashboard: https://app.tikomni.com
+- API: https://api.tikomni.com
+- Docs: https://docs.tikomni.com
+- Issues: https://github.com/mark-ly-wang/TikOmni-Skills/issues

package/README.zh-CN.md

@@ -0,0 +1,167 @@
+# TikOmni Skills
+
+中文 | [English](./README.md)
+
+让 AI Agent 直接使用 TikOmni 的跨平台内容获取与结构化分析能力。
+
+适用于 `Codex`、`Claude Code`、`OpenClaw`。  
+面向内容抓取、单作品分析、创作者分析、搜索结果、评论线程、榜单、直播间和结构化结果产出。
+
+- Website: https://tikomni.com
+- Dashboard: https://app.tikomni.com
+- API Docs: https://docs.tikomni.com
+- Releases: https://github.com/mark-ly-wang/TikOmni-Skills/releases
+
+## 为什么有这个仓库
+
+`TikOmni-Skills` 是 TikOmni 面向 AI Agent 的 Skill 交付层。
+
+它的目标不是堆一批平台脚本，也不只是沉淀几个固定模板；它更重要的作用，是把 TikOmni 的原能力组织成 Agent 可安装、可调用、可组合的 Skills，让 Agent 能直接完成：
+
+- 获取单条内容、账号主页和内容集合
+- 获取评论线程、搜索结果、榜单、直播间和商品页等具体对象
+- 提取标题、文案、字幕、转写和结构化字段
+- 输出标准化 JSON 与 Markdown 卡片
+- 基于真实抓取结果继续做分析、总结和归档
+
+如果你把 TikOmni 看作跨平台能力底座，这个仓库就是把这些能力交付给 Agent 的使用层。
+
+## 📦 支持平台
+
+当前目录覆盖主流平台（示例）：
+
+- 抖音、小红书、快手、B站、微博
+- TikTok、YouTube、Instagram、Threads、Twitter/X、Reddit、LinkedIn
+- 视频号、公众号、头条、西瓜、知乎、Lemon8、皮皮虾
+
+完整列表见官方文档目录：https://docs.tikomni.com
+
+## 🧩 可获取哪些结构化数据
+
+按不同平台/接口可返回：
+
+- 作者/账号信息
+- 作品/视频基础信息
+- 评论与回复数据
+- 搜索结果、榜单结果、直播间信息、商品相关数据
+- 互动指标（点赞、评论、分享等，视接口可用性）
+- 字幕/转写/文案文本（接口支持时）
+- 媒体地址等可提取资源（接口支持时）
+- 路由与请求追踪信息（方便复现）
+
+## Skill 模块
+
+| Skill | 作用 | 典型任务 |
+| --- | --- | --- |
+| `meta-capability` | 通用能力层 | 跨平台获取、路由探索、结构化抓取，以及评论线程、搜索、榜单、直播间、商品页等对象的通用执行与兜底 |
+| `single-work-analysis` | 单作品专项 Skill | 单个视频、单篇笔记、单条帖子、单篇文章的提取与分析 |
+| `creator-analysis` | 创作者专项 Skill | 账号主页、作者页、频道页、内容集合的抓取与聚合分析 |
+
+选择建议：
+
+- 想分析单个内容对象：安装 `single-work-analysis`
+- 想分析账号主页或内容集合：安装 `creator-analysis`
+- 想保留通用 TikOmni 能力入口：安装 `meta-capability`
+- 不确定会用到哪些场景：直接安装 `all`
+
+## 当前更成熟的高频链路
+
+在通用能力层之上，本仓库已经沉淀出一批更适合直接复用的高频方案。
+
+当前重点验证和持续打磨的方向包括：
+
+- Douyin 单作品分析
+- Xiaohongshu 单作品分析
+- Douyin 创作者主页分析
+- Xiaohongshu 创作者主页分析
+
+这些链路代表当前最成熟、最适合直接上手的实践路径。  
+它们很重要，但不等于本仓库能力边界的全部定义。
+
+## 30 秒快速开始
+
+### 1. 注册并获取 API Key
+
+- 官网：https://tikomni.com
+- 控制台：https://app.tikomni.com
+- API 文档：https://docs.tikomni.com
+
+### 2. 安装 Skills
+
+如果 npm 包已发布，可以直接使用：
+
+```bash
+npx @tikomni/skills list
+npx @tikomni/skills install codex all
+npx @tikomni/skills install claude-code creator-analysis
+npx @tikomni/skills install openclaw meta-capability --dir "/custom/skills"
+```
+
+默认安装目录：
+
+- `codex` -> `$CODEX_HOME/skills`，默认 `~/.codex/skills`
+- `claude-code` -> `~/.claude/skills`
+- `openclaw` -> 优先 `~/.openclaw/workspace/skills`，否则 `~/.openclaw/skills`
+
+如果你暂时不走 npm 分发，也可以手动把目标 Skill 目录复制到对应运行时的 `skills` 目录。
+
+### 3. 配置环境变量
+
+推荐做法：
+
+- CLI 安装后，目标 `skills` 根目录会自带一份共享 [`env.example`](./env.example)
+- 把这份 `skills/env.example` 复制为 `skills/.env`
+- 如有局部覆盖需求，再在对应 Skill 目录下增加 `.env.local`
+
+最少需要配置：
+
+```bash
+TIKOMNI_API_KEY="your_real_key"
+TIKOMNI_OUTPUT_ROOT="/absolute/path/to/tikomni-output"
+TIKOMNI_CARD_ROOT="/absolute/path/to/tikomni-cards"
+```
+
+更多高级变量见 [`env.example`](./env.example)。
+
+## 也可以直接让 Agent 帮你安装
+
+除了手动执行命令，你也可以直接对 Agent 说：
+
+- “帮我把 TikOmni skills 全部安装到 Codex。”
+- “把 `creator-analysis` 安装到 Claude Code 的 skills 目录。”
+- “把 `meta-capability` 安装到 OpenClaw，目标目录是 `/custom/skills`。”
+
+## 安装完成后怎么用
+
+配置完成后，可以直接通过自然语言发起任务，例如：
+
+- “提取这个抖音视频的结构化信息和字幕。”
+- “分析这个小红书笔记，输出作品卡和内容拆解。”
+- “抓取这个抖音主页近 20 条内容，并总结选题方向。”
+- “分析这个小红书账号，输出作者画像和代表性内容特征。”
+- “搜索这个关键词下的抖音结果，并整理前 20 条内容特征。”
+- “获取这个直播间的信息并输出结构化摘要。”
+
+## 版本与发布
+
+当前包版本见 [`package.json`](./package.json)。
+
+更多版本与发布信息见：
+
+- [Releases](https://github.com/mark-ly-wang/TikOmni-Skills/releases)
+- [`RELEASING.md`](./RELEASING.md)
+- [`RELEASING.zh-CN.md`](./RELEASING.zh-CN.md)
+
+## 安全说明
+
+- 不要把真实 API Key 提交到 Git
+- 不要在日志、截图或产物中泄露敏感配置
+- 建议使用 `.env` / `.env.local` 管理本地密钥
+
+## 相关链接
+
+- Website: https://tikomni.com
+- Dashboard: https://app.tikomni.com
+- API: https://api.tikomni.com
+- Docs: https://docs.tikomni.com
+- Issues: https://github.com/mark-ly-wang/TikOmni-Skills/issues

package/bin/tikomni-skills.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+"use strict";
+
+const {
+  installSkills,
+  listAvailableSkills
+} = require("../lib/installer");
+
+function printUsage() {
+  console.log(`TikOmni Skills CLI
+
+用法:
+  tikomni-skills list
+  tikomni-skills install <codex|claude-code|openclaw> <skill...|all> [--dir <path>] [--force]
+
+示例:
+  tikomni-skills list
+  tikomni-skills install codex all
+  tikomni-skills install claude-code creator-analysis
+  tikomni-skills install openclaw meta-capability --dir "/custom/skills"
+`);
+}
+
+function parseFlags(argv) {
+  const positionals = [];
+  let explicitDir = null;
+  let force = false;
+  let json = false;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (token === "--dir") {
+      explicitDir = argv[index + 1];
+      index += 1;
+      continue;
+    }
+    if (token === "--force") {
+      force = true;
+      continue;
+    }
+    if (token === "--json") {
+      json = true;
+      continue;
+    }
+    positionals.push(token);
+  }
+
+  return {
+    positionals,
+    explicitDir,
+    force,
+    json
+  };
+}
+
+function printList(asJson) {
+  const skills = listAvailableSkills().map((entry) => entry.name);
+  if (asJson) {
+    console.log(JSON.stringify(skills, null, 2));
+    return;
+  }
+
+  console.log("可安装 skills:");
+  for (const skill of skills) {
+    console.log(`- ${skill}`);
+  }
+}
+
+function printInstallResult(result) {
+  console.log(`运行时: ${result.runtime}`);
+  console.log(`目标目录: ${result.destinationRoot}`);
+  console.log("已安装:");
+  for (const entry of result.installed) {
+    console.log(`- ${entry.name} -> ${entry.targetPath}`);
+  }
+
+  if (result.runtime === "codex") {
+    console.log("请重启 Codex 以加载新 skills。");
+    return;
+  }
+  if (result.runtime === "claude-code") {
+    console.log("请重启 Claude Code 以加载新 skills。");
+    return;
+  }
+  console.log("请让 OpenClaw 重新加载 skills 目录。");
+}
+
+function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+    printUsage();
+    return;
+  }
+
+  const { positionals, explicitDir, force, json } = parseFlags(argv);
+  const [command, ...rest] = positionals;
+
+  if (command === "list") {
+    printList(json);
+    return;
+  }
+
+  if (command === "install") {
+    const [runtime, ...skills] = rest;
+    if (!runtime) {
+      throw new Error("install 命令必须提供运行时");
+    }
+
+    const result = installSkills({
+      runtime,
+      explicitDir,
+      force,
+      skillNames: skills
+    });
+    printInstallResult(result);
+    return;
+  }
+
+  throw new Error(`未知命令: ${command}`);
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(`[FAIL] ${error.message}`);
+  process.exitCode = 1;
+}

package/env.example

@@ -0,0 +1,160 @@
+# TikOmni shared environment example
+# TikOmni 共享环境变量示例
+#
+# [ZH] 用法：将本文件复制到 "skills/.env" 后再填写真实值。
+# [EN] Usage: copy this file to "skills/.env" and then fill in your real values.
+#
+# [ZH] 如果某个 skill 需要局部覆盖，请在对应目录新建 ".env.local"。
+# [EN] If one skill needs local overrides, create ".env.local" inside that skill folder.
+#
+# [ZH] 当前默认读取顺序：process env（仅启用时） > skill/.env.local > skills/.env
+# [EN] Current load priority: process env (when enabled) > skill/.env.local > skills/.env
+
+
+# =========================================================
+# Required shared config / 必填共享配置
+# =========================================================
+
+# [ZH] TikOmni API Key。默认值：无。必填。
+# [EN] TikOmni API key. Default: none. Required.
+TIKOMNI_API_KEY=""
+
+# [ZH] 所有 JSON 结果、错误结果、运行缓存的总根目录。默认值：无。必填，且必须是绝对路径。
+# [EN] Root directory for JSON results, error outputs, and runtime artifacts. Default: none. Required and must be absolute.
+TIKOMNI_OUTPUT_ROOT="/absolute/path/to/tikomni-output"
+
+# [ZH] 所有 Markdown 卡片的总根目录。默认值：无。必填，且必须是绝对路径。
+# [EN] Root directory for Markdown cards. Default: none. Required and must be absolute.
+TIKOMNI_CARD_ROOT="/absolute/path/to/tikomni-cards"
+
+
+# =========================================================
+# Common runtime / 通用运行参数
+# =========================================================
+
+# [ZH] TikOmni API 基础地址。默认值：https://api.tikomni.com
+# [EN] TikOmni API base URL. Default: https://api.tikomni.com
+TIKOMNI_BASE_URL="https://api.tikomni.com"
+
+# [ZH] HTTP 请求超时时间，单位毫秒。默认值：60000
+# [EN] HTTP request timeout in milliseconds. Default: 60000
+TIKOMNI_TIMEOUT_MS="60000"
+
+# [ZH] 全局请求 QPS 节流。默认值：5.0
+# [EN] Global request QPS throttle. Default: 5.0
+TIKOMNI_GLOBAL_QPS="5.0"
+
+# [ZH] 请求超时后的最大重试次数。默认值：3
+# [EN] Max retry count after request timeout. Default: 3
+TIKOMNI_TIMEOUT_RETRY_MAX="3"
+
+# [ZH] 超时重试的基础退避时间，单位毫秒。默认值：300
+# [EN] Base backoff for timeout retries in milliseconds. Default: 300
+TIKOMNI_TIMEOUT_RETRY_BACKOFF_MS="300"
+
+# [ZH] 自定义 HTTP User-Agent。默认值：内置浏览器样式 UA。通常不需要修改。
+# [EN] Custom HTTP User-Agent. Default: built-in browser-like UA. Usually no need to change.
+# TIKOMNI_HTTP_USER_AGENT="Mozilla/5.0 ..."
+
+# [ZH] 自定义 Accept-Language 请求头。默认值：zh-CN,zh;q=0.9,en;q=0.8
+# [EN] Custom Accept-Language header. Default: zh-CN,zh;q=0.9,en;q=0.8
+TIKOMNI_HTTP_ACCEPT_LANGUAGE="zh-CN,zh;q=0.9,en;q=0.8"
+
+
+# =========================================================
+# Output directory model / 结果输出目录模型
+# =========================================================
+
+# [ZH] 运行中间产物目录名，位于 TIKOMNI_OUTPUT_ROOT 下。默认值：_runs
+# [EN] Runtime artifact subdirectory name under TIKOMNI_OUTPUT_ROOT. Default: _runs
+TIKOMNI_OUTPUT_RUNS_DIR="_runs"
+
+# [ZH] 成功结果目录名，位于 TIKOMNI_OUTPUT_ROOT 下。默认值：results
+# [EN] Successful result subdirectory name under TIKOMNI_OUTPUT_ROOT. Default: results
+TIKOMNI_OUTPUT_RESULTS_DIR="results"
+
+# [ZH] 失败结果目录名，位于 TIKOMNI_OUTPUT_ROOT 下。默认值：_errors
+# [EN] Failed result subdirectory name under TIKOMNI_OUTPUT_ROOT. Default: _errors
+TIKOMNI_OUTPUT_ERRORS_DIR="_errors"
+
+
+# =========================================================
+# Card routing / 卡片落盘路由
+# =========================================================
+
+# [ZH] 路由语言预设。默认值：zh
+# [EN] Route locale preset. Default: zh
+TIKOMNI_PATH_LOCALE="zh"
+
+# [ZH] 作品卡文件名前缀。默认值：CBV
+# [EN] Work card filename prefix. Default: CBV
+TIKOMNI_CARD_PREFIX_WORK="CBV"
+
+# [ZH] 作者卡文件名前缀。默认值：CBA
+# [EN] Author card filename prefix. Default: CBA
+TIKOMNI_CARD_PREFIX_AUTHOR="CBA"
+
+# [ZH] 作者样本卡文件名前缀。默认值：CBV
+# [EN] Author sample card filename prefix. Default: CBV
+TIKOMNI_CARD_PREFIX_AUTHOR_SAMPLE_WORK="CBV"
+
+# [ZH] 卡片文件名模板。默认值：{prefix}-{author_slug}-{title_slug}{ext}
+# [EN] Card filename pattern. Default: {prefix}-{author_slug}-{title_slug}{ext}
+TIKOMNI_FILENAME_PATTERN_CARD="{prefix}-{author_slug}-{title_slug}{ext}"
+
+# [ZH] JSON 结果文件名模板。默认值：{timestamp}-{platform}-{identifier}{ext}
+# [EN] JSON output filename pattern. Default: {timestamp}-{platform}-{identifier}{ext}
+TIKOMNI_FILENAME_PATTERN_JSON="{timestamp}-{platform}-{identifier}{ext}"
+
+# [ZH] 兼容旧变量，仅影响卡片文件名，不推荐继续使用。默认值：空
+# [EN] Legacy compatibility variable, only affects card filenames, not recommended. Default: empty.
+# TIKOMNI_FILENAME_PATTERN="{prefix}-{author_slug}-{title_slug}{ext}"
+
+# [ZH] 显式覆盖作品卡目录路由，使用 "|" 分隔层级。默认值：空。
+# [EN] Explicit work-card route override, using "|" as separator. Default: empty.
+# [ZH] zh 默认：内容系统|对标研究|作品卡
+# [EN] zh preset default: 内容系统|对标研究|作品卡
+# [EN] en preset default: content-system|benchmark-research|work-cards
+# TIKOMNI_CARD_ROUTE_WORK="content-system|benchmark|work-cards"
+
+# [ZH] 显式覆盖作者卡目录路由，使用 "|" 分隔层级。默认值：空。
+# [EN] Explicit author-card route override, using "|" as separator. Default: empty.
+# [ZH] zh 默认：内容系统|对标研究|作者卡
+# [EN] zh preset default: 内容系统|对标研究|作者卡
+# [EN] en preset default: content-system|benchmark-research|author-cards
+# TIKOMNI_CARD_ROUTE_AUTHOR="content-system|benchmark|author-cards"
+
+# [ZH] 显式覆盖作者样本卡目录路由，使用 "|" 分隔层级。默认值：空。
+# [EN] Explicit author-sample-card route override, using "|" as separator. Default: empty.
+# [ZH] zh 默认：内容系统|对标研究|作者样本卡|{platform}-{author_slug}
+# [EN] zh preset default: 内容系统|对标研究|作者样本卡|{platform}-{author_slug}
+# [EN] en preset default: content-system|benchmark-research|author-sample-cards|{platform}-{author_slug}
+# TIKOMNI_CARD_ROUTE_AUTHOR_SAMPLE_WORK="content-system|benchmark|author-sample-cards|{platform}-{author_slug}"
+
+
+# =========================================================
+# Explicit config file / 显式配置文件
+# =========================================================
+
+# [ZH] 显式指定某个 skill 的 defaults.yaml 或自定义 YAML 配置路径。默认值：空。
+# [EN] Explicit path to a skill defaults.yaml or custom YAML config file. Default: empty.
+# [ZH] 若留空，则每个 skill 自动使用自己的 references/config-templates/defaults.yaml
+# [EN] If empty, each skill automatically uses its own references/config-templates/defaults.yaml
+# TIKOMNI_CONFIG_FILE=""
+
+
+# =========================================================
+# Creator-analysis only / 仅 creator-analysis 使用
+# =========================================================
+
+# [ZH] 作者级 LLM 分析超时，单位秒。默认值：45
+# [EN] Timeout for creator-level LLM analysis in seconds. Default: 45
+TIKOMNI_AUTHOR_ANALYSIS_TIMEOUT_SEC="45"
+
+# [ZH] sampled works 少于该阈值时跳过作者级 LLM 分析。默认值：5
+# [EN] Skip creator-level LLM analysis when sampled works are below this threshold. Default: 5
+TIKOMNI_AUTHOR_ANALYSIS_SMALL_SAMPLE_SKIP="5"
+
+# [ZH] sampled works 批量解释阶段超时，单位秒。默认值：45
+# [EN] Timeout for sampled-work batch explanation stage in seconds. Default: 45
+TIKOMNI_SAMPLED_EXPLANATION_TIMEOUT_SEC="45"