Agent skill

Cheat Publish Registration

by XBuilderLAB in XBuilderLAB/cheat-on-content

Records that a piece of content went live by writing its URL, platform and publish time into the prediction file header and state file, leaving the prediction text untouched.

MITAuto-check: notesMarketing & SEO

SKILL.md written in Chinese; this summary is our English description.

Install Cheat Publish Registration

skills CLI
$ npx skills add XBuilderLAB/cheat-on-content --skill cheat-publish -a claude-code

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

GitHub CLI
$ gh skill install XBuilderLAB/cheat-on-content cheat-publish --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/XBuilderLAB/cheat-on-content.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cheat-publish .claude/skills/cheat-publish && 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
cheat-publish
GitHub stars
7.2k
Token cost
~1.3k tokens
SKILL.md length
335 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
MIT

At a glance

Records that a piece of content went live by writing its URL, platform and publish time into the prediction file header and state file, leaving the prediction text untouched.

  • Works in 5 steps: 找到对应的预测文件 → 解析平台 → 更新 prediction 文件 header → …
  • Registering a post's link right after publishing it in a prediction workflow
  • SKILL.md covers Overview, Constants, Inputs and Workflow, plus 3 more sections
  • Reaches v.douyin.com

What it does

This is a light step in a workflow where each post is first blind-predicted and later compared with results. The agent finds the matching prediction file, from an explicit path, from the in-progress session in `.cheat-state.json`, or by listing prediction files whose header lacks a publish time, and it warns if the gap between that session and the URL is more than 14 days. It detects the platform from the URL (YouTube, Bilibili, Douyin, Xiaohongshu, WeChat, Substack, Medium or Twitter and X), and asks you for the publish time rather than scraping it.

Only the metadata block above the prediction section is edited, with the Edit tool, adding the publish time, platform, URL and platform-specific IDs such as an aweme ID, BV number, note ID or video ID; short links are marked pending for a later retrospective step. A hook blocks changes to the prediction text and the skill says to report a wrongly triggered hook, not bypass it. It also reminds you that looking at later data breaks the blind claim, and then updates the state file. The text is in Chinese.

When your agent uses it

  • Registering a post's link right after publishing it in a prediction workflow
  • Adding the platform and publish time to a prediction file's header
  • Finding which prediction files are still missing a publish record

Example prompts

  • “已发布,链接是 https://v.douyin.com/abc123,帮我登记一下。”
  • “I shipped it, the YouTube link is https://youtu.be/example, register the publish.”
  • “List the prediction files that have no published time yet.”

Requirements

  • A project with prediction files and a `.cheat-state.json` state file
  • Pre-approved tools (allowed-tools): Bash(*), Read, Edit, Glob

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 找到对应的预测文件
  2. 解析平台
  3. 更新 prediction 文件 header
  4. 更新 state file
  5. 提醒 + 下一步 + buffer 状态

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(*)
    • Read
    • Edit
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown and json).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • v.douyin.com

    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

Cheat Publish Registration loads about 1.3k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 335 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash(*), Read, Edit, Glob

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 XBuilderLAB/cheat-on-content at commit 2d8211e, republished under its MIT licence (© XBuilderLAB). 335 words, ~1,263 tokens.

Download SKILL.mdSave it as .claude/skills/cheat-publish/SKILL.md (or your agent's skills folder).
name
cheat-publish
description
登记一篇内容已发布,把 URL/平台 ID/发布时间写入对应预测文件 header 和 state file。这是一个轻量动作——只更新元数据,**不动预测段任何字符**。触发词:"已发布"/"I shipped"/"发布链接是 X"/"刚发完 [url]"/"publish registered"。
allowed-tools
Bash(*), Read, Edit, Glob
argument-hint
<prediction-file-or-url> [— platform: youtube|bilibili|douyin|...]

/cheat-publish — 发布登记

把作品的发布元数据(URL、发布时间、平台)补到预测文件 header 与 state file。禁止改预测段——hook 会拦。

Overview

[用户:已发布 https://...]
  ↓
[Phase 0: 找到对应的预测文件]   ← 通过 in_progress_session 或匹配
  ↓
[Phase 1: 解析 URL → 平台/发布时间]
  ↓
[Phase 2: 更新 prediction 文件 header(仅 metadata 段)]
  ↓
[Phase 3: 更新 .cheat-state.json,清除 in_progress_session]

Constants

  • AUTO_DETECT_PLATFORM = true — 从 URL 模式自动识别平台
  • VERIFY_BLIND = true — 提醒用户:从此刻起看到任何后续数据都会破坏盲度声明的诚信

Inputs

必填来源
<prediction-file> 或 URL用户参数;缺失则用 .cheat-state.json 的 in_progress_session.file
.cheat-state.json用户项目根

Workflow

Phase 0: 找到对应的预测文件

按优先级:

  1. 用户参数明确给了 prediction 文件路径 → 用它
  2. 用户参数只给了 URL → 读 .cheat-state.json 的 in_progress_session.file
  3. 都没有 → 列出 predictions/*.md 中 header 没填 published_at 的文件,让用户选

警告路径:若 in_progress_session.file 与用户给的 URL 时间差超过 14 天 → 提示"这个预测写于很久之前,确认是这篇?"

Phase 1: 解析平台

AUTO_DETECT_PLATFORM=true 时按 URL 模式:

URL 模式平台
youtube.com/* youtu.be/*youtube
bilibili.com/* b23.tv/*bilibili
douyin.com/* iesdouyin.com/* v.douyin.com/*douyin
xiaohongshu.com/* xhslink.com/*xhs
mp.weixin.qq.com/*wechat
substack.com/* *.substack.com/*substack
medium.com/* *.medium.com/*medium
twitter.com/* x.com/*twitter
其他unknown — 询问用户

发布时间获取:

  • 不强求自动抓——绝大多数平台需要登录态
  • 询问用户:"发布时间是?(默认:现在)" → 接受 ISO 8601 或自然语言("今天 14:30" / "20 分钟前")
  • 解析失败 → 用 now()
Phase 2: 更新 prediction 文件 header

绝不触碰 ## 预测 段及之后。只动文件最顶部的 metadata 块。

读文件,定位到 metadata 块(在第一个 ## 之前的所有行)。检查是否已有这些字段——有则警告"已登记过"并询问是否覆盖;无则追加:

markdown
**Published at**: 2026-05-04T14:32:00+08:00
**Platform**: douyin
**URL**: https://v.douyin.com/abc123
**Video Folder**: videos/2026-05-04_a3f2c1d4_停止期待/
**Aweme ID**: 7234567890123456789  (douyin / 视频号 等需要的 platform-specific ID)

关于 platform-specific ID:

  • 抖音:从 URL 短链 resolve 后提取 aweme_id(v.douyin.com → 重定向后含 modal_id 或 item_id 参数)
  • B 站:BV 号
  • 小红书:note_id
  • YouTube:v= 参数后的 video_id

如果用户给的是分享短链(无法立刻 resolve)→ 标 Aweme ID: pending,下次 /cheat-retro 时由 adapter 解析。

video folder 处理:到 cheat-publish 这一步,对应的 videos/<id>/ 目录应该已经由 cheat-shoot 创建(含 script.md)。

  • 如 video folder 不存在 → 警告"你跳过了 cheat-shoot?建议先跑 cheat-shoot 把拍摄稿登记进 video folder 再发",询问用户是否跳过登记直接发:
    • 是 → 自动建一个 video folder(fallback),但不询问稿子一致性,标 ad_hoc_publish: true
    • 否 → 让用户先跑 cheat-shoot 再回来 publish

用 Edit 工具(不是 Write 重写整个文件)。

hook 行为预期:因为只动 metadata 段(在 ## 预测 之前),immutability hook 应放行。如果 hook 误拦 → 报告 bug,不要绕过 hook。

Phase 3: 更新 state file
json
{
  "in_progress_session": null,
  "last_published_at": "<ISO timestamp>",
  "last_published_file": "predictions/<filename>",
  "last_published_video_folder": "videos/<...>/",
  "last_published_platform_id": "<aweme_id 或 BV 号 等>",
  "pending_retros": [
    "predictions/<filename>"
  ],
  "shoots": [
    // 移除 video_folder 匹配本次发布的项;buffer -1
  ]
}

shoots 队列处理(buffer 跟踪关键):

  1. 读 state.shoots[]
  2. 找 video_folder == 本次发布的 video_folder 的项 → 移除
  3. 如果没找到 → 警告"buffer 队列里没有这条视频。是直接发布没经过 /cheat-shoot 吗?"——不阻塞,但提示用户下次走 /cheat-shoot 让 buffer 跟踪准确

last_published_platform_id 是 cheat-retro 调 adapter 时的输入——如 douyin-session 需要 aweme_id 直接抓数据。

pending_retros 是待复盘列表——cheat-status 会基于这个列表 + RETRO_WINDOW_DAYS 显示"今天该复盘哪些"。

Phase 4: 提醒 + 下一步 + buffer 状态
✅ 登记完成:predictions/2026-05-04_a3f2c1d4e5b6_停止期待.md
   - Published at: 2026-05-04 14:32
   - Platform: douyin
   - URL: https://v.douyin.com/abc123

📦 Buffer:N 篇(颜色 + 含义)
   按你的 cadence(X)= N×X 天 buffer
   [如颜色变了,提示"现在该去拍/暂停拍"]

⚠️  从此刻起,你看到任何关于这条作品的播放/点赞/评论数据
    都会破坏盲度声明的诚信。如果不小心看到,告诉我——
    我会在文件里追加一个 integrity warning。

📅 计划复盘:T+3d,约 2026-05-07
   到时间说:"复盘 predictions/2026-05-04_..."

Buffer 颜色由 shared-references/cadence-protocol.md 派生。如本次发布让 buffer 跌入红色(断更风险)→ 高亮警告"今天必须再拍 ≥1 条"。

Key Rules

  1. 不动预测段。即使是修复笔误,也不允许在 publish 时改预测段
  2. 不抓数据。publish 是登记动作,不是数据回收(那是 cheat-retro 的活)
  3. state 字段名固定。pending_retros / last_published_at 是其他子 skill(特别是 cheat-status / cheat-retro)依赖的契约
  4. 平台未知不强报。无法识别 → 询问用户,允许 platform: other 作为兜底
  5. 重复登记需明示。已有 published_at → 询问"覆盖?",绝不静默覆盖

Refusals

  • 「我顺手把预测段也改一下」 → 拒绝。请走 _redo.md 路径
  • 「URL 我等会儿补,先把发布时间记上」 → 允许:URL 字段可后续追加;published_at + platform 必填
  • 「跳过 metadata 更新,直接清 in_progress_session」 → 拒绝。元数据是复盘时的关键上下文(特别是 platform 决定数据回收用哪个 adapter)

Integration

  • 上游:/cheat-predict(写出 prediction 文件并设 in_progress_session)
  • 下游:T+RETRO_WINDOW_DAYS 后 → /cheat-retro
  • cheat-status 用 pending_retros 字段计算"今天该复盘哪些"
  • 平台字段被 cheat-retro 用来路由到对应的 perf-data adapter(manual-paste / youtube-data-api / 等)

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

Files

Just SKILL.md in skills/cheat-publish of XBuilderLAB/cheat-on-content.

Open the folder on GitHubat commit 2d8211e

Compare with similar skills

Cheat Publish Registration 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.

Cheat Publish Registration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cheat Publish Registration this skillXBuilderLAB/cheat-on-content7.2k—~1.3kAutomated safety check: NotesMIT
Ra Video DownloadPluviobyte/rnskill1.6k—~861Automated safety check: NotesCustom licence
Schedule Socialindranilbanerjee/digital-marketing-pro8541 repos~3.4kAutomated safety check: PassMIT
Social Media Pro Maxcriptogus/agent-evolve-network288—~1.6kAutomated safety check: PassCustom licence
Creator Analytics MasterFerroxLabs/wayland608—~3.6kAutomated safety check: PassApache-2.0
Agent ReachPanniantong/Agent-Reach93k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Ra Video Download

    Pluviobyte/rnskill

    Download source video or audio from Douyin, YouTube, Bilibili, Twitter/X, Xiaohongshu, and other yt-dlp-supported URLs into the content-creation workspace.

    1.6k GitHub stars~861 tokensUpdated 16 days ago
    Media & CreativeAuto-check: notes
  • Schedule Social

    indranilbanerjee/digital-marketing-pro

    Schedule social posts to Twitter/X, Instagram, LinkedIn, TikTok, YouTube, and Pinterest through connected platform MCPs — generating per-platform copy variations, hashtag mixes, media-spec…

    854 GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check passed
  • Social Media Pro Max

    criptogus/agent-evolve-network

    State-of-the-art viral content + social design intelligence.

    288 GitHub stars~1.6k tokensUpdated 27 days ago
    Writing & ContentAuto-check passed
  • Creator Analytics Master

    FerroxLabs/wayland

    Cross-platform analytics mastery for content creators covering YouTube, Instagram, TikTok, Twitter/X, podcast, and newsletter metrics, audience demographic analysis, content performance patterns…

    608 GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    93k GitHub stars~1.4k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed
  • Video Podcast Maker

    Agents365-ai/video-podcast-maker

    A skill your agent uses when the user gives a topic and wants an automated topic-driven narrated explainer, podcast, or knowledge-summary video (Bilibili / YouTube / Xiaohongshu / Douyin / WeChat…

    1.7k GitHub stars~4.9k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed

More from XBuilderLAB/cheat-on-content

All 16 skills in this repo
  • Rubric Bump Proposer

    XBuilderLAB/cheat-on-content

    Proposes and applies upgrades to a content-scoring rubric: a full formula bump with blind re-scoring and a cross-model audit, or a lighter bucket-boundary recalibration.

    7.2k GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check: notes
  • Cheat-on-Content Setup

    XBuilderLAB/cheat-on-content

    Onboards a new user to the cheat-on-content workflow with a short question flow, creating the project scaffolding and optionally importing past video history.

    7.2k GitHub stars~4.3k tokensUpdated 2 days ago
    Auto-check: notes
  • Benchmark Account Importer

    XBuilderLAB/cheat-on-content

    Imports scripts and engagement numbers from an account you want to emulate, then extracts content patterns and starting scoring signals from them.

    7.2k GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check: notes
  • cheat-on-content State Migrator

    XBuilderLAB/cheat-on-content

    Upgrades an older .cheat-state.json to the current schema version by applying migration files in order, with dry-run, backup and stop-on-failure behavior.

    7.2k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check: notes
  • Cheat on Content Calibration

    XBuilderLAB/cheat-on-content

    Turns content creation into a calibrated loop of scoring, blind prediction, post-publish review and rubric evolution, with a built-in rubric for opinion videos.

    7.2k GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check: notes
  • Audience Persona Builder

    XBuilderLAB/cheat-on-content

    Builds or refreshes an account's audience profile from the comments in its post retrospectives and writes it to audience.md for later topic and script work.

    7.2k GitHub stars~1.5k tokensUpdated 2 days ago
    Auto-check: notes

Questions about Cheat Publish Registration

What does Cheat Publish Registration do?

Records that a piece of content went live by writing its URL, platform and publish time into the prediction file header and state file, leaving the prediction text untouched. This is a light step in a workflow where each post is first blind-predicted and later compared with results.json`, or by listing prediction files whose header lacks a publish time, and it warns if the gap between that session and the URL is more than 14 days.

When should I use Cheat Publish Registration?

Cheat Publish Registration fits situations like: registering a post's link right after publishing it in a prediction workflow; adding the platform and publish time to a prediction file's header; finding which prediction files are still missing a publish record.

How do I install Cheat Publish Registration in Claude Code?

Run `npx skills add XBuilderLAB/cheat-on-content --skill cheat-publish -a claude-code`. Or copy the skill folder (skills/cheat-publish in XBuilderLAB/cheat-on-content) into .claude/skills/cheat-publish in your project. Claude Code loads it when a task matches its description.

How do I install Cheat Publish Registration in Codex?

Run `npx skills add XBuilderLAB/cheat-on-content --skill cheat-publish -a codex`. Or copy the skill folder (skills/cheat-publish in XBuilderLAB/cheat-on-content) into .agents/skills/cheat-publish in your project. Codex loads it when a task matches its description.

Can I use Cheat Publish Registration 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 XBuilderLAB/cheat-on-content --skill cheat-publish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cheat-publish, .gemini/skills/cheat-publish, .github/skills/cheat-publish and .opencode/skills/cheat-publish in your project.

What does Cheat Publish Registration need to run?

SKILL.md names no scripts, command-line tools or credentials: Cheat Publish Registration is instructions for the agent only. Our summary lists: A project with prediction files and a `.cheat-state.json` state file. Its frontmatter pre-approves these tools: Bash(*), Read, Edit, Glob.

Does Cheat Publish Registration access the network?

SKILL.md names 1 domain. In commands or code: v.douyin.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Cheat Publish Registration safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Cheat Publish Registration use?

Cheat Publish Registration 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 Cheat Publish Registration use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cheat Publish Registration?

Skills that share tags, products or a category with Cheat Publish Registration: Ra Video Download (Pluviobyte/rnskill, 1.6k stars), Schedule Social (indranilbanerjee/digital-marketing-pro, 854 stars), Social Media Pro Max (criptogus/agent-evolve-network, 288 stars) and Creator Analytics Master (FerroxLabs/wayland, 608 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cheat Publish Registration?

XBuilderLAB (a GitHub organization) maintains it in XBuilderLAB/cheat-on-content, which has 7,225 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 5, 2026.

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