DESIGN.md@skill-cron/docsA

DESIGN.md@skill-cron/docs from kerberosclaw/kc_ai_skills is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add kerberosclaw/kc_ai_skills/skill-cron/docs/DESIGN.md@git:20260714.a933fb9

Pins git:20260714.a933fb9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
kerberosclaw/kc_ai_skills
Path
skill-cron/docs/DESIGN.md
Versions recorded
5
Latest version
git:20260714.a933fb9, committed Jul 14, 2026
First version recorded
Apr 9, 2026
Size
6,379 bytes
Repository stars
79
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# skill-cron — 因為 `claude -p "/your-skill"` 會卡住

> **English summary:** Design doc for skill-cron, a launchd-based scheduler for Claude Code skills. Born from discovering that `claude -p "/skill"` hangs silently — skills only work in interactive mode. Solution: a `headless-prompt` field in SKILL.md frontmatter + a runner script. Uses macOS launchd (not crontab) because `claude -p` needs the user's login session for OAuth — crontab runs in a bare daemon context without it. Includes Telegram push via urllib and auto-rotating logs.

## 這東西為什麼存在

Claude Code 的 skill 在互動模式下很好用 — 打 `/your-skill` 就跑。但如果你想用排程定時跑呢?

```bash
# 你以為可以這樣
claude -p "/your-skill"

# 實際上會無限卡住,沒有任何輸出
# 我們在凌晨一點 debug 了 40 分鐘才搞懂為什麼
```

官方文件寫了,但埋在一段不起眼的地方:

> "User-invoked skills like `/commit` are only available in interactive mode. In `-p` mode, describe the task you want to accomplish instead."

翻譯:**`claude -p` 不支援 `/skill` 語法。** 它不會報錯,它只是卡住。靜靜地。直到你 `Ctrl+C`。

所以你得用直接描述的方式:

```bash
# 這個能跑
claude -p "Run python3 ~/.claude/skills/morning-brief/scripts/fetch_news.py --top 5, then summarize..."
```

但你不可能把這種一百字的 prompt 塞進排程設定。於是 skill-cron 誕生了。

---

## 設計思路

### 職責分離

```
Skill(如 /morning-brief)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kerberosclaw/kc_ai_skills/skill-cron/docs/DESIGN.md@sha256:bcae6345f26a693c

The line at the top of this page pins the label git:20260714.a933fb9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_g52onslozt6a2k42.svg)](https://markdownregistry.com/a/art_g52onslozt6a2k42)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Apr 9, 2026 and Jul 14, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20260714.a933fb9 latest2026-07-14 a933fb9 6,379 BA view · diff
git:20260410.75734942026-04-10 7573494 6,385 BA view · diff
git:20260409.2f26b942026-04-09 2f26b94 5,458 BA view · diff
git:20260409.835a75d2026-04-09 835a75d 5,044 BA view · diff
git:20260409.8df70702026-04-09 8df7070 5,037 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (6379 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kerberosclaw/kc_ai_skills · 79 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g52onslozt6a2k42
GET https://markdownregistry.com/api/v1/resolve?ref=kerberosclaw/kc_ai_skills/skill-cron/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/bcae6345f26a693c36908f2f0a6c68fe7d4fb3477d413ca0efc0cced82f1dc2c

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what DESIGN.md is and how agents use it · which agent file does what.

More from kerberosclaw/kc_ai_skills

adr SKILL.md skill
kerberosclaw/kc_ai_skills · adr/SKILL.md · Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to…
v0.3.1 · audit A · 79 stars
align SKILL.md skill
kerberosclaw/kc_ai_skills · align/SKILL.md · Reconcile existing repository documentation with the current implementation, especially after verified hotfixes or…
v0.4.0 · audit A · 79 stars
character-lora SKILL.md skill
kerberosclaw/kc_ai_skills · character-lora/SKILL.md · Use when the user wants to build a consistent-identity LoRA for an original character — defining the character…
v0.2.1 · audit A · 79 stars
conference-report SKILL.md skill
kerberosclaw/kc_ai_skills · conference-report/SKILL.md · Use when the user attended one or more sessions of a conference (with audio recordings + slide photos) and needs help…
v0.2.0 · audit A · 79 stars
ctf-kit SKILL.md skill
kerberosclaw/kc_ai_skills · ctf-kit/SKILL.md · Use when the user is solving an authorized CTF / lab reverse-engineering challenge focused on Windows application…
v0.5.0 · audit A · 79 stars
diagnose SKILL.md skill
kerberosclaw/kc_ai_skills · diagnose/SKILL.md · Use when the user reports misbehaving software to investigate — a bug, crash, wrong output, flaky behavior, or…
v0.3.0 · audit A · 79 stars
goal-engineer SKILL.md skill
kerberosclaw/kc_ai_skills · goal-engineer/SKILL.md · Author a self-contained unattended dispatch for a generate-and-select loop (generate candidates, grade, iterate, keep…
v1.3.2 · audit A · 79 stars
DESIGN.md@goal-engineer/docs DESIGN.md file
kerberosclaw/kc_ai_skills · goal-engineer/docs/DESIGN.md
git:20261015.be10792 · audit A · 79 stars
gpt-image-gen SKILL.md skill
kerberosclaw/kc_ai_skills · gpt-image-gen/SKILL.md · Use when the user asks to generate OR edit an image via GPT/Codex (e.g. 「叫 gpt 生圖」「幫我用 gpt 生圖」「gpt 畫一個…
v0.6.0 · audit A · 79 stars
grill SKILL.md skill
kerberosclaw/kc_ai_skills · grill/SKILL.md · Use when the user says 先討論 / wants to align on a fuzzy idea before building, or before any non-trivial implementation…
v0.1.0 · audit A · 79 stars
ios-resign SKILL.md skill
kerberosclaw/kc_ai_skills · ios-resign/SKILL.md · Use when the user wants to rebuild, re-sign and reinstall one of their own iOS apps onto their iPhone(s) — typically…
v0.1.1 · audit A · 79 stars
job-scout SKILL.md skill
kerberosclaw/kc_ai_skills · job-scout/SKILL.md · Use when the user is considering applying to, interviewing with, or accepting an offer from a company and wants due…
v1.1.0 · audit A · 79 stars

Every file in kerberosclaw/kc_ai_skills

Browse by kind, by grade A, or by owner.