worklog-kit: Skill for Codex

.agents/skills/worklog-init/SKILL.md

worklog-init is a skill for Codex from iyuenan3/worklog-kit. It costs 110 tokens per session (3,957 once invoked), scanned A, original, Apache-2.0.

An interactive setup guide for initializing a worklog vault, which is a repository used to store project notes and diaries. It checks the operating system, Git identity, repository visibility, remote access, and required tools before configuring the vault.

In plain words
What is it for?
Use it when setting up or updating a worklog-kit repository. It guides configuration, checks whether the repository is private or public, and supports safe reruns of an existing setup.
Why use it?
It prevents initialization in the wrong repository and avoids overwriting existing configuration. It also identifies missing Git, GitHub, or push access before later steps depend on them.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is iyuenan3/worklog-kit's own configuration. It tells Codex how to work on worklog-kit itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything worklog-kit configures →

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is bash .agents/skills/worklog-ingest/scripts/repo-visibility.sh # 零参数,只读查询当前仓 remote.

Reuse

Borrowing it

Nothing to install: this file belongs to iyuenan3/worklog-kit. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/iyuenan3/worklog-kit/main/.agents/skills/worklog-init/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/iyuenan3/worklog-kit

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for worklog-init

README.md
[![agentmods](https://agentmods.dev/badge/skills/iyuenan3/worklog-kit/worklog-init/github.svg)](https://agentmods.dev/skills/iyuenan3/worklog-kit/worklog-init)
Your own site
<a href="https://agentmods.dev/skills/iyuenan3/worklog-kit/worklog-init"><img src="https://agentmods.dev/badge/skills/iyuenan3/worklog-kit/worklog-init/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for worklog-init

Your own site · 80×15
<a href="https://agentmods.dev/skills/iyuenan3/worklog-kit/worklog-init"><img src="https://agentmods.dev/badge/skills/iyuenan3/worklog-kit/worklog-init.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 110 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,957 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00110 $0.03957
Opus 5.5 $0.00044 $0.01583
Sonnet 5.5 $0.00022 $0.00791
Haiku 4.5 $0.00011 $0.00396

Measured 2mo ago against content hash 3acdd898dcf7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

worklog-init scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/discover.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/worklog-init/SKILL.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

worklog-init:vault 初始化向导

你是 worklog vault 的初始化向导。与 ingest 相反,本 skill 是交互式的:这是用户唯一一次需要坐在屏幕前配置的环节,每一步都可以提问确认。与用户交互使用用户的语言(跟随其消息语言)。

前置与安全

  • 只在 worklog-kit 模板仓(根目录有 worklog.config.yaml + wiki/ + diaries/)里运行;不在则说明并退出。
  • 重跑安全:config 含 initialized_at 字段(Step 3 写入的初始化标记)→ 进入「更新模式」,只改用户点名的项;绝不整文件覆盖已配置的 config、绝不覆盖用户改过的骨架文件。
  • 本 skill 不做任何网络拉取(三件套随模板自带);只在 visibility 检测与鉴权预检时调用 gh / git 远端命令。

流程(9 步,顺序执行;Step 8 与 Step 9 可选)

Step 1 · 环境预检

逐项检查并汇总成一张表(✅ / ⚠️ / ❌):

uname -s                                   # Darwin / Linux 通过;其它(原生 Windows)→ ❌ 终止并说明仅支持 macOS / Linux
grep -qi microsoft /proc/version 2>/dev/null && echo WSL   # uname 区分不了 WSL;命中 → ⚠️ 标注「WSL 实验性支持」
git config --get user.name; git config --get user.email   # 缺 → 引导设置(commit 必需)
git remote -v                              # 无 remote → ⚠️ 提示先建私有远端(无人值守 push 需要)
BRANCH=$(git branch --show-current); test -n "$BRANCH" && git push --dry-run origin "HEAD:refs/heads/$BRANCH"   # 真正验证 push 权限,仅当上一步检测到 remote 才跑;失败 → 给 SSH key / gh auth 两条修复路径
command -v gh && gh auth status           # 无 gh 或未认证 → ⚠️(visibility 检测与 github 源需要;修复命令 gh auth login,可后补)
command -v python3                         # 无 → ⚠️(lint 与部分脚本需要)
command -v uv || command -v uvx            # 无 → ⚠️(素材摄入 markitdown 需要;可后补)

❌ 项修完再继续;⚠️ 项记入收尾报告,不阻塞。

Step 2 · 仓库 visibility 检测(隐私第一道闸)

bash .agents/skills/worklog-ingest/scripts/repo-visibility.sh   # 零参数,只读查询当前仓 remote
  • 结果非 private → 红色警告并暂停:日记与 wiki 将包含你的工作细节,必须先到仓库 Settings 改为 Private 再继续。用户明确表示接受公开风险才可跳过(记入报告)。
  • 无 gh / 无 remote → 提醒「无法自动检测,请自行确认私有」并记入报告。

Step 3 · 生成 config(问「你的工作都发生在哪」)

交互收集后整体展示一遍再写入 worklog.config.yaml:

  1. 语言 language:zh / en(决定骨架 locale 与写作规范)
  2. 时区 timezone 与 日期分割线 day_boundary(解释:凌晨工作归前一天的分界,按作息选,默认 07:00)
  3. 身份 identities:从 git config --get user.email 预填,追问「还有别的 commit 署名 email 吗(公司邮箱等)」
  4. 数据源 sources,逐类问:
    • 本机项目都在哪些目录 / 硬盘?→ local-git.roots(多硬盘 = 多 root;提示:给具体的项目父目录而非家目录,自动发现深度有限且不跟随符号链接)
    • 有 GitHub / GitLab 账号且工作会 push 上去吗?→ github / gitlab 源(gitlab 连接器尚未实现:config 会保留,ingest 暂跳过并记一句,如实告知)
    • 有「工作不经过托管平台」的远程机器吗?→ remote-ssh(提示连通性文档,推荐 Tailscale);必追问「那台机器上项目都在哪些目录」写进该源 roots(ingest 要把 scan.sh 发到远端跑,没有 roots 无从扫起)
    • 用飞书等 IM 协调工作吗?→ im 源(提示:Feishu 与 lark-cli 完全选配且默认同机执行;需另跑 feishu-setup 完成认证、生成 gitignored 作用域并逐项同意读取范围;默认只记你自己发的消息)
    • 有不用 git 的项目目录(写作 / 设计)吗?→ local-dir 显式声明(活动感知默认只看 4 层深,按 客户/年/项目 组织的深目录建议给该条目配 depth: 键)
    • 是否同意把 Agent 记忆作为只读证据源?→ 检测并逐项展示 Codex ~/.codex/memories、Claude ~/.claude/projects/*/memory{,.pre-*}、stash ~/.local/share/project-memory/*/memory 等候选,用户同意的才写成 agent-memory 条目。每条含匹配 [a-z0-9][a-z0-9._-]* 的稳定 name、paths 与可选 optional: true;路径支持单文件、目录或 glob。Qoder、Cursor 等其他工具只接受用户给出的路径或官方文档、本机实测确认的长期记忆路径,不根据应用目录名猜测,不把命令、规则、索引或缓存目录冒充长期记忆。说明扫描仅按 mtime 选候选文件,内容仍按来源隔离读取,不复制、不合并、不回写

Read the full file on GitHub · 139 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 139 lines · 110 tokens per session scan A 3acdd898dcf7

Subscribe to this mod's changes

worklog-init is a skill published in the GitHub repository iyuenan3/worklog-kit (11 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 110 tokens to every session and 3,957 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

worklog-init compared with skills from other repositories

worklog-init next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
worklog-initiyuenan3/worklog-kitSkill113mo agoApache-2.0A110Codex
orbit-notionnexu-io/open-designSkill106kyesterdayApache-2.0A117Claude Code, Codex
agentmailpaperclipai/paperclipSkill111kyesterdayMITA30Claude Code, Codex
Cortexdanielmiessler/LifeOSSkill20kyesterdayMITA184Claude Code
rowboat-spacesrowboatlabs/rowboatSkill18kyesterdayApache-2.0A60Claude Code, Codex
feishuHmbown/CodeWhaleSkill41k5d agoMITA33Claude Code, Codex
pinchtab-mcppinchtab/pinchtabSkill11k10d agoMITA52Claude Code, Codex