Agent skill

Divination

by tradecatlabs in tradecatlabs/fatecat

Structured fortune-telling workflow skill using MCP tools. An agent skill from tradecatlabs/fatecat.

MITAuto-check passedAgent Workflows

Install Divination

skills CLI
$ npx skills add tradecatlabs/fatecat --skill divination -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tradecatlabs/fatecat divination --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tradecatlabs/fatecat.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tools/reference-repos/github/taibu-master/skills/divination .claude/skills/divination && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
divination
GitHub stars
202
Token cost
~924 tokens
SKILL.md length
340 words
Files
8 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Structured fortune-telling workflow skill using MCP tools. An agent skill from tradecatlabs/fatecat.

  • Works in 8 steps: Identify domain and call matching MCP… → Finish required steps in domain workflow… → Mark uncertainty explicitly when inputs… → …
  • Users ask for divination
  • SKILL.md covers Overview, Global Rules, Tool Selection and Response Contract, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Divination is an agent skill from tradecatlabs/fatecat. Structured fortune-telling workflow skill using MCP tools. Use when users ask for divination, 八字/四柱, 六爻, 紫微斗数, 塔罗, 大运, 运势/流年, or want standardized解读流程 (e.g., 八字先看身强弱与喜用神再看大运流年). Enforce fixed analysis order, call the right MCP tool, and produce actionable interpretations.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/bazi-workflow.md`, `references/dayun-workflow.md` and `references/liuyao-workflow.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: FateCat measurement infrastructure for Agents and apps: reproducible Bazi/Ziwei calculations, evidence-oriented reports, FastAPI, Web, Telegram and CLI. The licence is MIT.

When your agent uses it

  • Users ask for divination
  • Want standardized解读流程 (e.g.
  • 八字先看身强弱与喜用神再看大运流年)

Example prompts

  • “/divination”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Identify domain and call matching MCP tool first.
  2. Finish required steps in domain workflow before writing final judgment.
  3. Mark uncertainty explicitly when inputs are incomplete.
  4. Do not generate fear-based or deterministic harmful statements.
  5. End with practical, low-risk actions users can take.
  6. Error Handling: 工具调用失败时,根据错误类型处理
  7. Calendar Awareness: 用户给出农历日期时,务必设置 calendarType: 'lunar';闰月须设 isLeapMonth: true。
  8. ⏰ Time Awareness: 分析前先获取当前时间(年月日),用于

What it can do on your machine

Read from SKILL.md and the folder at commit c9b9857. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Divination loads about 924 tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 340 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~924
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tradecatlabs/fatecat at commit c9b9857, republished under its MIT licence (© tradecatlabs). 340 words, ~924 tokens.

Download SKILL.mdSave it as .claude/skills/divination/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
divination
description
Structured fortune-telling workflow skill using MCP tools. Use when users ask for divination, 八字/四柱, 六爻, 紫微斗数, 塔罗, 大运, 运势/流年, or want standardized解读流程 (e.g., 八字先看身强弱与喜用神再看大运流年). Enforce fixed analysis order, call the right MCP tool, and produce actionable interpretations.

Mingli MCP Assistant

Overview

Use this skill to deliver consistent,流程化命理解读 for end users.

  • Follow a fixed analysis sequence by domain instead of free-form interpretation.
  • Use MCP outputs as evidence; do not jump to conclusions without data anchors.
  • Separate 结论、依据、建议 in every response.

Global Rules

  1. Identify domain and call matching MCP tool first.
  2. Finish required steps in domain workflow before writing final judgment.
  3. Mark uncertainty explicitly when inputs are incomplete.
  4. Do not generate fear-based or deterministic harmful statements.
  5. End with practical, low-risk actions users can take.
  6. Error Handling: 工具调用失败时,根据错误类型处理:
    • 输入校验错误 → 提示用户补正具体缺失/错误字段
    • 日期/范围越界 → 明示有效范围(如 1900-2100)
    • 内部计算错误 → 告知"计算暂不可用",不要编造数据
  7. Calendar Awareness: 用户给出农历日期时,务必设置 calendarType: 'lunar';闰月须设 isLeapMonth: true。
  8. ⏰ Time Awareness: 分析前先获取当前时间(年月日),用于:
    • 大运定位:根据当前年份计算用户年龄,定位当前大运步
    • 流年判断:确定当前流年干支
    • 每日运势:确定当日日期
    • 紫微大限:根据年龄定位当前大限

Tool Selection

  • Bazi:
    • If only四柱 provided: bazi_pillars_resolve → (user confirms) → bazi.
    • If birth datetime provided: bazi.
    • If need大运列表: additionally call dayun_calculate.
  • Liuyao: liuyao_analyze
    • AI must judge yongShenTargets from question semantics before calling.
    • Use method: 'select' with hexagramName when user provides a known hexagram.
  • Ziwei: ziwei
  • Tarot: tarot_draw
    • Choose spreadType based on question complexity: single (quick), three-card (standard), love (relationships), celtic-cross (deep).
  • DaYun (大运):
    • Use dayun_calculate for standalone大运查询.
    • Also used as supplement in Bazi/Time-Trend workflows.
  • Daily fortune:
    • Use daily_fortune for day-level advice.
    • If dayMaster or birth info available, include for personalized十神. Detailed schema/required args: references/mcp-tool-matrix.md.

Response Contract

Always output with this section order:

  1. 结论摘要 (3-5 lines)
  2. 核心依据 (data points from MCP output)
  3. 分步解读 (by domain workflow)
  4. 时间节奏 (near/mid/far term)
  5. 行动建议 (specific and feasible)
  6. 风险与边界 (what cannot be inferred confidently)

Domain Workflows

  • 八字流程: references/bazi-workflow.md
  • 六爻流程: references/liuyao-workflow.md
  • 紫微流程: references/ziwei-workflow.md
  • 塔罗流程: references/tarot-workflow.md
  • 大运流程: references/dayun-workflow.md
  • 运势流程: references/time-trend-workflow.md

Follow these files in order. Do not skip mandatory checkpoints.

Mixed Consultation Strategy

When users ask cross-domain questions, use this order:

  1. Bazi/Ziwei as personality-base and long cycle.
  2. DaYun (dayun_calculate) / Daily fortune as time window adjustment.
  3. Liuyao/Tarot as event-level confirmation.
  4. If signals conflict, prioritize:
    • Stable long-cycle indicators over single-draw/event signals.
    • Multi-source consensus over single-source extremes.

Quick Ref

文件用途
mcp-tool-matrix.md工具参数速查
bazi-workflow.md八字解读流程
liuyao-workflow.md六爻解读流程
ziwei-workflow.md紫微斗数流程
tarot-workflow.md塔罗解读流程
dayun-workflow.md大运流年流程
time-trend-workflow.md运势时间线流程

© tradecatlabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in tools/reference-repos/github/taibu-master/skills/divination of tradecatlabs/fatecat.

  • SKILL.md
  • references/bazi-workflow.md
  • references/dayun-workflow.md
  • references/liuyao-workflow.md
  • references/mcp-tool-matrix.md
  • references/tarot-workflow.md
  • references/time-trend-workflow.md
  • references/ziwei-workflow.md

Open the folder on GitHubat commit c9b9857

Compare with similar skills

Divination next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Divination compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Divination this skilltradecatlabs/fatecat202—~924Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Fastmcp Client CLIPrefectHQ/fastmcp28k1 repos~823Automated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 64 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub starsUsed in 1 repo~823 tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from tradecatlabs/fatecat

  • Fatecat

    tradecatlabs/fatecat

    FateCat 执行型测算基础设施 skill:安装并校验当前仓库,执行生产化 capability,输出 JSON / Markdown,启动 Web / API / Telegram 交付层,并在发布前运行仓库卫生与生产就绪门禁。Use when 用户要求测算、排盘、生成报告、启动 Web/API/Bot、验收 skill、导出 bundle、检查生产可用性。

    202 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check: notes
  • Meihua Divination

    tradecatlabs/fatecat

    Structured Chinese-style divination and fate-reading skill for questions about current fortune, relationships, career choices, project momentum, and personal tendencies.

    202 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Aov Mingyu API

    tradecatlabs/fatecat

    通过 aov.cc 公开 API 调用命理、占卜和一站式提示词能力。用于需要八字排盘、紫微斗数排盘、六爻、梅花易数、奇门遁甲、大六壬、小六壬、塔罗、三山国王灵签、黄历择日、雷诺曼、星盘,或直接返回可交给 AI 解读的完整提示词的任务。

    202 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Create Master

    tradecatlabs/fatecat

    基于佛教经典文献,生成特定高僧大德的 AI 教学角色

    202 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check: notes

Categories

Questions about Divination

What does Divination do?

Structured fortune-telling workflow skill using MCP tools. An agent skill from tradecatlabs/fatecat. Divination is an agent skill from tradecatlabs/fatecat. Structured fortune-telling workflow skill using MCP tools.

When should I use Divination?

Divination fits situations like: users ask for divination; want standardized解读流程 (e.g; 八字先看身强弱与喜用神再看大运流年).

How do I install Divination in Claude Code?

Run `npx skills add tradecatlabs/fatecat --skill divination -a claude-code`. Or copy the skill folder (tools/reference-repos/github/taibu-master/skills/divination in tradecatlabs/fatecat) into .claude/skills/divination in your project. Claude Code loads it when a task matches its description.

How do I install Divination in Codex?

Run `npx skills add tradecatlabs/fatecat --skill divination -a codex`. Or copy the skill folder (tools/reference-repos/github/taibu-master/skills/divination in tradecatlabs/fatecat) into .agents/skills/divination in your project. Codex loads it when a task matches its description.

Can I use Divination in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tradecatlabs/fatecat --skill divination -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/divination, .gemini/skills/divination, .github/skills/divination and .opencode/skills/divination in your project.

What does Divination need to run?

SKILL.md names no scripts, command-line tools or credentials: Divination is instructions for the agent only.

Does Divination access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Divination safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Divination use?

Divination is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Divination use?

About 924 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6k tokens, read only when the agent opens those files.

What are the alternatives to Divination?

Skills that share tags, products or a category with Divination: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Divination?

tradecatlabs (a GitHub user) maintains it in tradecatlabs/fatecat, which has 202 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on August 25, 2026.

Source: tradecatlabs/fatecat on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.