worklog-lint

worklog-lint is a skill for Claude Code, Codex from iyuenan3/worklog-kit. It costs 136 tokens per session (858 once invoked), scanned A, original, Apache-2.0.

A health-check skill for a worklog vault, meaning a folder of linked notes and diaries. It checks required files, diary dates, possible credentials, broken links, writing rules, and maintenance signals.

In plain words
What is it for?
It is for running vault lint checks, checking dates and punctuation where configured, reporting broken references and stale content, and verifying fixes after they are approved.
Why use it?
It separates urgent problems, such as exposed credentials or missing required files, from advisories and general maintenance suggestions.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/iyuenan3/worklog-kit/worklog-lint
Any agent
npx skills add iyuenan3/worklog-kit --skill worklog-lint
Clone the repo
git clone --depth 1 https://github.com/iyuenan3/worklog-kit

Made for: Claude Code, 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-lint

README.md
[![agentmods](https://agentmods.dev/badge/skills/iyuenan3/worklog-kit/worklog-lint.svg)](https://agentmods.dev/skills/iyuenan3/worklog-kit/worklog-lint)
Your own site
<a href="https://agentmods.dev/skills/iyuenan3/worklog-kit/worklog-lint"><img src="https://agentmods.dev/badge/skills/iyuenan3/worklog-kit/worklog-lint.svg" alt="Measured on agentmods" height="20"></a>
Per session 136 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 858 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.00136 $0.00858
Opus 5 $0.00068 $0.00429
Sonnet 5 $0.00027 $0.00172
Haiku 4.5 $0.00014 $0.00086

Measured 5d ago against content hash 373a67619c5b, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

worklog-lint 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 5d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/lint.py), 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-lint/SKILL.md · 42 lines

What it actually says

worklog-lint:vault 健康检查

与用户交互的语言跟随其消息语言。只检查与报告,修复动作逐项经用户确认(除非用户明说「直接修」)。

流程

  1. 通用机械项
python3 .agents/skills/worklog-lint/scripts/lint.py

🔴 must-fix(exit 1):契约锚点缺失、疑似凭证、diary frontmatter 缺 date(只查 YYYY-MM-DD.md 命名的文件,同步冲突副本等杂件降为 advisory)。🟡 advisory:断链(跨库引用可忽略,判断前先问用户该链接是否指向 vault 外)、项目页 frontmatter 缺字段、log.md / index.md 增长超阈值该轮转归档、diaries/ 里的非日记命名文件。凭证扫描的有意示例行可加行内 lint:ignore 标记豁免(仅正文区生效,config 不豁免)。

  1. 写作门(复用 ingest 随包脚本,脚本不存在则提示「worklog-ingest 未安装或版本过旧,跳过写作门」不报错)。标点门仅 language: zh 跑;日期门 zh / en 都跑(脚本同时识别中英两套星期写法):
python3 .agents/skills/worklog-ingest/scripts/punctuation_check.py <改动过的 md 或用户点名的文件>   # 仅 zh
python3 .agents/skills/worklog-ingest/scripts/date_weekday_check.py --all
  1. 健康节(体检,非正误项):
python3 .agents/skills/worklog-lint/scripts/lint.py --health

🩺 项是维护建议不是错误(退出码 2 = 有待维护项,不算 lint 失败;0 = 健康):状态漂移 / 孤儿页 / 实体分裂候选 / 膨胀 / TODO 年龄五项,阈值在 config maintenance: 段(缺省用脚本内置默认值)。

  1. 报告:按 🔴 / 🟡 / 🩺 分组列出,🔴 🟡 每条附一句「怎么修」;🔴 建议当场修(凭证类必须当场处理并提醒若已 push 需轮换该凭证),🟡 尊重用户节奏;🩺 指引「说『维护 vault』处理」(修复归 worklog-maintain,本 skill 不代修健康项)。
  2. 修复(经确认,仅 🔴 🟡):逐项修,修完重跑对应检查验证归零。

边界

  • 凭证命中即最高优先级:先处理再谈别的;已入 git 历史的凭证提醒「删除文件不够,需轮换凭证本身」。
  • 断链不自动删改(可能是用户有意的跨库引用);log 轮转属结构操作,给命令让用户跑或经确认代跑。
Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

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. 5d ago First seen · 42 lines · 136 tokens per session scan A 373a67619c5b

Subscribe to this mod's changes

worklog-lint is a skill published in the GitHub repository iyuenan3/worklog-kit (11 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 136 tokens to every session and 858 once invoked, about $0.0007 per session on Opus 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.